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AND MAINTAINING INTERNET DOMAIN NAME 
REGISTRATIONS 
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RELATED APPLICATION 

This application claims the benefit of U.S. Provisional Application No. 60/153,960, filed 
September 15, 1999, the disclosure of which is expressly incorporated herein by reference. 
Copending U.S. Patent Application Serial No. 09/544,305, filed April 6, 2000, is also expressly 
5 incorporated herein by reference. 

FIELD OF THE INVENTION 

The present invention relates to the field of domain name registration. More particularly, 
the invention relates to methods and apparatus, which provides an application program interface to 
1 0 enable the registration and maintenance of Internet domain names. 

BACKGROUND OF THE INVENTION 

The explosive growth of the Internet has created the need for orderly management of the 
process for creating domain name registrations (also known as Web addresses) and subsequent 
administrative activities such as changes in ownership, renewals, and so forth. Until recently, 
Network Solutions, Inc. of Herndon, Virginia was the exclusive entity through which domain name 
registrations ("DNRs") were acquired and registered, at least for domain names ending in .com, 
.net, .org and .edu. In such role, Network Solutions, Inc. is known as a Registrar. Approximately 
five million Web addresses have been registered by Network Solutions, Inc. so far. 

Presently-implemented systems for registration of Web Addresses rely almost exclusively 
on the use of e-mails between users and the Registrar for each step of the process. For example, 
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FIG. 4 shows the sequence of steps for registration, a customer (Registrant) prepares to register 

new Web Address 100; 

The Registrant fills out a Service Agreement (102). The Service Agreement is submitted 

by e-mail to the Registrant, for example, to hostmaster@intemic.net (step 104). The Request is 
5 automatically assigned a tracking number 106. The Service Agreement is automatically checked 

for errors 108. The Service Agreement is processed if there are no errors and the registrant is 

notified via e-mail when completed 1 12. Web Address registration is complete with a message. 

For example, the message may read: "Your Web Address registration is complete" (step 1 14). The 

customer is invoiced for the Web Address registration, step 1 16, and pays for the registration (step 
10 118). 

Finally, the Registrar sends a re-registration notice to registrant 60 days before the two year 
anniversary of the initial registration (step 120). Should there be an error in the Service 
Agreement, the registration process is not completed and an e-mail is sent to the customer 
informing it of the problem (step 1 10). 

1 5 While this process works effectively, it is not without certain shortcomings. Most notably, 

the use of the Internet for e-mailing notices is not generally on a "real-time" basis. It may 
sometimes take several days for an e-mail to be delivered, particularly to parts of the world where 
the Internet support structure is not fully established. In addition, e-mails may become corrupted 
which creates further delays since the recipient must ask for the messages to be resent. 

20 Further, recent events have resulted in the development of a concept termed "Wholesaling" 

by which other organizations, such as Internet Services Providers ("ISP"), Internet hosting 
providers, Internet portals and Electronic Commerce Providers are allowed to secure such DNRs 
on behalf of their own customers. In effect, such organizations act as their own Registrars by 



-3- 



WO 01/20484 PCT7US00/25305 

offering their customers an interface which permits unsophisticated and sophisticated users to 
interface with the registration process and subsequent management thereof. Ultimately, however, 
DNRs are still issued by the Registrar, Network Solutions, Inc. 

This expansion in the number of outlets for securing DNRs has led to the development of 

5 systems and methods to facilitate wholesaling. 

Network Solutions, Inc. provides the NSI Wholesale Service Protocol ("WSP"), which 
establishes support of a real-time programmable interface for the purchase and management of 
Network Solutions, Inc. ("NSI") products and services a system. This system would permit users 
seeking registrations to complete the process, regardless of their level of expertise in computer 

10 technology in general, and the Internet in particular. The WSP uses a simple, connection-based, 
synchronized, ASCII text-based protocol to communicate with an NSI Wholesale System over the 
Internet, thereby allowing Wholesalers to securely and reliably create, modify, and delete customer 
accounts and various products including the registration and management of Internet domain 
names. 

1 5 The WSP consists of a set of commands that a Wholesaler may issue to create customers or 

domain-name-related products. Each command returns a set of 'properties' and major and minor 
error codes. In many cases, the result of one command is used as input to the next command. 

Wholesale commands are either synchronous or asynchronous. Generally, customer 
creation and management commands are synchronous, while domain creation and management 

20 commands are asynchronous. An "as-fast-as-possible" fulfillment system for asynchronous 

commands maintains queues in order to guarantee that the order is not lost in the case of external 
system problems. Typical synchronous response times are several seconds or less, while 
asynchronous times, for example, to complete a registration, are typically less than a few minutes. 
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There are two primary security mechanisms in the NSI Wholesale System. All 
Wholesalers must supply the IP addresses from which they will connect and establish Secure 
Socket Layer ("SSL") connections to the NSI Wholesale System. They also must use an account 
number and password when issuing session commands. NSI provides these ahead of time to 

5 Wholesalers. While this system provides numerous advantages over the prior art, there is a need to 

make the system universally available. 

Accordingly, there is presently a need for methods and apparatus which provides an 
application program interface to allow computer application programs of other users, to access the 
Wholesale system and to conduct transactions associated with the registration and management of 

10 Internet domain names in the same manner as the WSP. 



SUMMARY OF THE INVENTION 

To achieve these objects and other advantages and in accordance with the purposes of the 
invention, as embodied and broadly described herein. The present invention is directed to methods 
and apparatus for interfacing a user application program to a system for conducting transactions 
associated with managing Internet domain names by establishing over the Internet a connection 
between the user and the system; authenticating the right of the user to conduct a transaction 
associated with managing Internet domain names; establishing a secure socket layer within the 
application program interface and the system; receiving a request in the application program 
interface from the applications program to initiate a transaction following such authentication; and 
transmitting commands by the application program interface to the system effectuating the 
transaction. 
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BRIEF DESCRIPTION OF THE DRAWINGS 

The accompanying drawings, which are incorporated in and constitute a part of this 
specification, illustrate an embodiment of the invention and together with the description, serve to 
explain the principles of the invention. In the drawings, 
5 FIG. 1 is a diagram of a preferred embodiment of the invention, wherein an application 

program interface, WSP Java API, implements the functionality of a WSP in a series of Java object 
classes; 

FIG. 2 shows an exemplary flowchart of the method for interfacing a user application 
program to a system for conducting transactions associated with managing Internet domain names; 
1 o FIG. 3 shows an exemplary diagram of the apparatus for interfacing a user application 

program to a system for conducting transactions associated with managing Internet domain names. 



DETAILED DESCRIPTION 

Reference will now be made in detail to the present preferred embodiment of the invention, 
15 an example of which is illustrated in the accompanying drawings. Wherever possible, the same 

reference numbers will be used throughout the drawings to refer to the same or like elements. 

The methods and apparatus provides an application program interface that is accessed by 
user application programs to establish a connection to a system for conducting transactions 
associated with managing Internet domain names. 
20 Referring to FIG. 1 , a computer application program 12 typically provides an interface to 

the user to collect customer data. The computer application program 12 typically issues a session 
request to the application program interface, WSP Java API 14, in order to establish a session over 
the Internet 10 with the Wholesale System 16 and to issue various commands. 

-6- 
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The WSP Java API 14 is essentially a Java 'wrapper 1 of the WSP. It consists of two main 
classes: NSIWholesaleAPI and WSPResponse. The NSIWholesaleAPI contains all of the methods 
for creating customers, products, and services. WSPResponse is a single class returned from most 
methods and contains the result of the issued command request and will optionally include any 
additional data that was generated by the request. 

One advantage of using WSP Java API 14 is that when the NSIWholesaleAPI object is 
created, the object creates a 'pool' of SSL connections to the Wholesale system 16. This class 
removes the need to issue a 'session' command, and removes the burden from a Wholesaler of 
making and managing SSL connections. Multi-threaded applications may also use this connection 
pool. 

FIG. 2, shows an exemplary flowchart of the invention. A user 20, sends a request to the 
application program 12 to conduct a transaction associated with managing Internet domain names. 
The application program 12 typically provides an interface to a user to collect customer data. The 
application program 12 typically issues a session request to the application program interface 14 to 
establish a session over the Internet 10 with the Wholesale System 16. The application program 
interface 14 will authenticate a user's right to conduct a transaction by attempting to connect to the 
Wholesale System 16 using user account information received from the application program 12. If 
the authentication fails, the application program interface 14 will attempt two additional 
authentications. The application program interface 14 will send the result of the authentication to 
the application program 12. If the authentication is successful, the application program interface 
14 will establish a secure socket layer with the Wholesale System 16. The application program 12 
will send a request to the application program interface 14 to make available the set of commands 
through the instantiation of an object of class NSIWholesaleAPI. The application program 1 2 
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may now send a request to any of the object methods to request the processing of a command. The 
application program interface 14 will receive the command request along with any data. The 
application program interface 14 will format the data and the command into a string as described in 
detail in the aforementioned copending U.S. Patent Application Serial No. 09/544,305. The 
application program 14 will then transmit the request across the Internet 10 to the Wholesale 
System 16 to effectuate the transaction. The Wholesale System 16 will process the request and 
will return the result of the transaction across the Internet 10 to the application program interface 
14. The application program interface 14 will send a response to the application program 12. 

FIG. 3, is a diagram of an exemplary computer environment in which methods consistent 
with the present invention may be implemented. A component is provided for a user 20, to send a 
request to the application program 12 to conduct a transaction associated with managing Internet 
domain names. The application program 12 typically provides an interface to user 20 to collect 
customer data. The application program 12 typically issues a session request to the application 
program interface 14 to establish a session over the Internet 10 with the Wholesale System 16. A 
component is also provided for authenticating the right of the user 20 to conduct a transaction. The 
application program interface 14 will authenticate a user's right to conduct a transaction by 
attempting to connect to the Wholesale System 16 using the user account information received 
from the application program 12. If the authentication fails, the application program interface 14 
will attempt two additional authentications. The application program interface 14 will send the 
result of the authentication to the application program 12. A component is also provided for 
establishing a secure socket layer if the authentication is successful. The application program 
interface 14 will establish a secure socket layer with the Wholesale System 16. A component is 
also provided for initiating a transaction following a successful authentication. The application 
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program 12 will send a request to the application program interface 14 to make available the set of 
commands that are available in the Wholesale System 16 through the instantiation of an object of 
class NSIWholesaleAPI. The application program 12 may now send a request to any of the object 
methods to request the processing of a command. The application program interface 14 will 
receive the command request along with any data. A component is also provided for transmitting 
commands through the secure socket layer. The application program interface 14 will format the 
data and command into a string as described in detail in the aforementioned copending U.S. Patent 
Application Serial No. 09/544,305. The application program 14 will then transmit the request 
across the Internet 10 to the Wholesale System 16 to effectuate the transaction. The Wholesale 
System 16 will process the request and return the result of the transaction across the Internet 10 to 
the application program interface 14. The application program interface 14 will send a response to 
the application program 12. 

The name of the WSP Java API configuration file is typically WSPj avaAPI , conf . This 
file contains specific information about each Wholesale user. The values for the parameters in that 
file are provided when a Wholesale agreement is completed with a Registrar, such as NSI. The file 
includes the following parameters: 

WholesaleAPI .minConnections=2 ~~ 

WholesaleAPI .maxConnections=2 

WholesaleAPI . connectionSoTimeout=120000 

WholesaleAPI . connect ionProtocol=WSPl . 5 

WholesaleAPI . server=XXX.netsol . com 

WholesaleAPI .port=X000 

WholesaleAPI . retry=l 

WholesaleAPI . WholesalerAccountId=12345678 
WholesaleAPI. WholesalerPassword=XXXXXXXX 
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The values indicated with an "X" will change from user to user. The definition of each of 
these parameters is as follows: 



Configuration File Parameters 



Name 


Type 


Typical Value 


Definition 


minConnections 


Positive 
Integer 


2 through 10 


Connection Pooling Tuning Parameter 


maxConnections 


Positive 
Integer 


minConnections 
through 5 


Connection Pooling Tuning Parameter 


connection S oTimeout 


Positive 
Integer 


120000 


Number of milliseconds of non-use 
before the API will time out a 
connection 


Server 


String 


X.netsol.com 


Server name for Wholesale protocol at 
Registrar. The exact name will be 
provided when the Wholesale agreement 
is established. 


Port 


Integer 


xxxx 


IP Port on the server for connection 


WholesalerAccountld 


String 


XXX 


Unique identifier of each Wholesale 
partner 


WholesalerPassword 


String 


xxxxxxx 


Unique code, necessary for connection 
to NSI, for Wholesale operations 



5 CLASS HIERARCHY 
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o class iava.lang. Obiect 

o class nsi.wholesale.toolkit.iavaapi. NSIWholesaleAPI 
o class iava.lang. ThrowabIe (implements javaio.Serializabie) 
o class iava.lang. Exception 

o class nsi>wholesale.toolkit.iavaapi. NSIWholesaleExceptioii 
o class nsi.wholesale.toolkit.iavaapi. WSPException 

o class nsi.wholesale,toolkit.iavaapi JnvalidArguinentException 
o class nsi.wholesale.toolkitiavaapi. InvalidResponseFormatException 
o class nsi.wholesale.toolkit.iavaapi. WSPResponse 



The NSIWholesaleAPI class constructs an instance of a new NSIWholesaleAPI object 
whose methods can be called to perform Wholesale-related activities, such as connecting to the 
Wholesale System 16 over the Internet through a SSL, and it allows the computer application 
program 12 to create and manage Internet domain names. The class definition for 
NSIWholesaleAPI includes the following: 



Constructor Summary 


NSIWholesaleAPI ( ) 


Method Summary 


WSPResponse 


createBusinessAccount (String aCompanyName , 




String aCompanyType , Strinq aAddressl, String aCity, 

String aCountryCode , Strinq aPhone, String aCus tome r Pas sword, 

String aAuthQuestion, String aAuthAnswer, 

String aLegalContactFirstName , String aLegal Contact Las tName) 

This method creates a business customer account and returns 
an automatically generated customer account id. 


WSPResponse 


createBusinessAccount (String aCompanyName, 




String aCompanyType, String aAddressl, String aCity, 

String aCountryCode, String aPhone, String a Customer Password, 
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Strinq aAuthQuestion, String aAuthAnswer, 

Strinq aLegalContactFirstName, Strinq aLegalContactLastName . 
Properties optionalAttributes) 

This method creates a business customer account and returns 
an automatically generated customer account id. 


WSPResponse 


createBusinessAccount (String aCompanyName , 




String aCompanyType , String aAddressl, String aCity, 

String aCountryCode, String aPhone, String aCustomerPassword, 

String aAuthQuestion, String aAuthAnswer, 

String aLegalContactFirstName, String aLegalContactLastName, 
String aState, String aPostalCode) 

This method creates a business customer account and returns 
an automatically generated customer account id. 


WSPResponse 


createBusinessAccount (String aCompanyName, 




String aCompanyType, String aAddressl, String aCity, 

String aCountryCode, String aPhone, String aCustomerPassword, 

Strinq aAuthQuestion, String aAuthAnswer, 

String aLegalContactFirstName, String aLegalContactLastName, 
String aState, String aPostalCode, 
Properties optionalAttributes) 

1 nis metnoo creates a ousiness customer account ana returns 
an automatically generated customer account id. 


WSPResponse 


createDnsHosting (String pCustomerAccountld, 




String pCustomer Password, String aDomainName) 

This method registers a DNS Hosting product for an existing 
customer account. 


WSPResponse 


createDnsHosting (String pCustomerAccountld, 




String pCustomerPassword, String aDomainName, 
Properties optionalAttributes) 

This method registers a DNS Hosting product for an existing 
customer account. 


WSPResponse 


createDomain (String pCustomerAccountld, 




String pCustomerPassword, String aDomainName, String aHostldl, 
String aHostId2, String aTechContactld) 

This method registers a new domain product for an existing 
customer account 


WSPResponse 


createDomain {String pCustomerAccountld, 




String pCustomerPassword, String aDomainName, String aHostldl, 
String aHostId2, Strinq aTechContactld, 
Properties optionalAttributes) 

This method registers a new domain product for an existing 
customer account. 


WSPResponse 


createDomain (String pCustomerAccountld, 




String pCustomerPassword, String aDomainName, 

String aHostNamel, String aHostAddrl, String aHostName2, 

Strinq aHostAddr2, Strinq aTechContactld) 

This method registers a new domain product for an existing 
customer account. 
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String pCustomerPas sword, String aDoma.inNa.me/ 

String aHostNamel, String aHostAddrl, String aHostName2, 

String aHostAddr2, String aTechContactld, 

Properties optionalAttributes) 

This method registers a new domain product for an existing 
customer account. 


WSPResponse 


createlndividualAccount {String aFirstName, String aLastName, 




String aAddressl, String aCountryCode, String aPhone, 
String aCustomerPassword, String aAuthQuestion, 
String aAuthAnswer, Strinq aCity) 

This method creates an individual customer account and returns 
an automatically generated customer account id. 








String aAddressl, String aCountryCode, String aPhone, 
String aCustomerPassword, String aAuthQuestion, 
String aAuthAnswer, String aCity, 
Properties optionalAttributes) 

This method creates an individual customer account and returns 
an automatically generated customer account id. 




prpafcpIndividualAccount fStrina aFirstName Strina aLastMame 

^ 1 CO UCAUU1 V AWABIArtVvvM** W ^ U X 1 13 Gil X> J- Ul 1 ! Olll^ / O \— X> J. A WlJUQ A. 1 Gillie / 




String aAddressl, String aCountryCode, String aPhone, 
String aCustomerPassword, String aAuthQuestion, 
String aAuthAnswer, String aCity, String aState, 
String aPostalCode) 

This method creates an individual customer account and returns 
an automatically generated customer account id. 


worKesponse 


CicaCcluUiviaualnwv>UUUt \ OL.illlvj aril £j LlNalllc , OL.1 lll^ auabLiMaiiic , 




Qt-rina aAddressl Strina aCountrvCode Strina aPhone, 
String aCustomerPassword, String aAuthQuestion, 
String aAuthAnswer, String aCity, String aState, 
String aPostalCode, Properties optionalAttributes) 

This method creates an individual customer account and returns 
an automatically generated customer account id. 


iiijr i\c □^/uiioc 


createT&chnicalContact ( String aFirstName, String aLastName, 




String aOrganization, String aAddressl, String aCountryCode, 
String aPhone, String aEmail, String aTechContact Password, 
String aCity) 

This method creates a technical contact and returns an 
automatically generated technical contact id (NIC Handle). 


WO IT i\C o jJUU DC 


rrpatPTechnicalConfcact ( strina aFirstName Strina aLastName. 




String aOrganization, String aAddressl, String aCountryCode, 
String aPhone, String aEmail, String aTechContactPassword, 
String aCity, Properties optionalAttributes) 

This method creates a technical contact and returns an 
automatically generated technical contact id (NIC Handle). 


WSPResponse 


createTechnicalContact (String aFirstName, String aLastName, 




String aOrganization, String aAddressl, String aCountryCode, 
String aPhone, String aEmail, String aTechContactPassword, 
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String aCity, String aState, String aPostalCode) 

This method creates a technical contact and returns an 
automatically generated technical contact id (NIC Handle). 


WSPResponse 


createTechnicalContact (String aFirstName, String aLastName, 


• 


String aOrganization, String aAddressl, String aCountryCode , 
String aPhone, String aEmail, String aTechContactPassword. 
ocring at-icy, oLriny aotate, otring dt'oscaiLOQc, 

riUpci ties upulvIlalnLLi.iiJJULCB; 

This method creates a technical contact and returns an 
automatically generated technical contact id (NIC Handle). 


WSPResponse 


describe (String pTarget) 

This method provides information about a specified target. 


WSPResponse 


describe (String pTarget, Properties optionalAttributes) 




This method provides information about a specified target. 


WSPResponse 


generateDomainName (String pKeyWords) 




i nis metnoa is useo xo generaie a iist or avanauie oomain 
names based on a specified list of keywords. 


WSPResponse 


generateDomainName ( String pKeyWords , 




Properties optionalAttributes) 

This method is used to generate a list of available domain 
names based on a specified list of keywords. 


static String 


get JdkVersion ( ) 

Static accessor method to get JDK version 


static long 


getSerialVersion ( ) 

Static accessor method to get serial version 


static double 


getVersionO 

Static accessor method to get release version 


UC PR p» cnnn c p> 


This method returns basic information about the supported 
protocol commands and classes. 


WSPResponse 


help (Properties optionalAttributes) 

This method returns basic information about the supported 
protocol commands and classes. 


static void 


init (Properties properties) 

Initializes the Wholesale Services Protocol API. 


: — 

static void 


. — . 

init (String conf lgFileNatue) 

Initializes the Wholesale Services Protocol API. 


WSPResponse 


lookupBusiness Account ( ) 




Retrieves a list of all business customer accounts linked to 
wholesaler. 


WSPResponse 


lookupBusinessAccount (Properties optionalAttributes) 




Retrieves a list of all business customer accounts linked to 
wholesaler. 
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WSPResponse 


lookupBusinessAccount (Strinq pCustomerAccountld, 




String pCustomer Pas sword) 

Retrieves details of a specific business customer account. 


WSPResponse 


lookupBusinessAccount (String pCustomerAccountld, 




DLring p^uouoiuecrassworu, rroperLicb opLionaiAUuriDUCcS j 

Retrieves details of a specific business customer account. 


WSPResponse 


lookupDnsHosting (String pCustomerAccountld, 




String pCustomerPassword) 

lACiricvcS a 1151 Of all UUiTlain names aSSOCIaieu Wim UImo 

Hosting products owned by customer. 


WSPResponse 


lookupDnsHosting (String pCustomerAccountld, 




String pCustomerPassword, Properties optionalAttributes) 

Keineves a list or an aomain names associateo witn UNo 
Hosting products owned by customer. 


WSPResponse 


lookupDnsHosting (String pCustomerAccountld, 




String pCustomerPassword, String pDomainName) 

Retrieves details of a specific DNS Hosting product owned by 
customer. 


WSPResponse 


lookupDnsHosting (String pCustomerAccountld, 




String pCustomerPassword, String pDomainName, 
Properties optionalAttributes) 

Retrieves details of a specific DNS Hosting product owned by 
customer. 


WSPResponse 


lookupDomain (String pCustomerAccountld, 




String pCustomerPassword) 

Retrieves a list of all domain products owned by customer. 


WSPResponse 


lookupDomain (String pCustomerAccountld, 




String pCustomerPassword, Properties optionalAttributes) 

Retrieves a list of all domain products owned by customer. 


WSPResponse 


lookupDomain (String pCustomerAccountld, 




String pCustomerPassword, String pDomainName) 

Retrieves detail information about a specific domain product 
registered to a customer. 


WSPResponse 


lookupDomain (String pCustomerAccountld, 




String pCustomerPassword, String pDomainName, 
Properties optionalAttributes) 

Retrieves detail information about a specific domain product 
registered to a customer. 


WSPResponse 


lookupDomainByTechContact (Strinq pCustomerAccountld, 




String pTechContactld, String pTechContactPassword) 

Retrieves a list of the customer's domain products for which the 
technical contact id is the technical contact. 


WSPResponse 


lookupDomainByTechContact (Strinq pCustomerAccountld, 




String pTechContactld, String pTechContactPassword, 
Properties optionalAttributes) 

Retrieves a list of the customer's domain products for which the 



-15- 



WO 01/20484 



PCT7US00/25305 





technical contact id is the technical contact. 


WSPResponse 


lookupDomainByTechContact (String pCustomerAccountld, 




Strinq pTechContactld, Strinq pTechContactPassword, 
String pDomainName) 

Retrieves details of a specific domain product owned by 
customer, for which the technical contact id is the technical contact for 
the specific product. 


WSPResponse 


lookupDomainByTechContact (String pCustomerAccountld, 




String pTechContactld, String pTechContact Password, 
String pDomainName, Properties optionalAttributes) 

Rotriia\/pQ HptailQ of a Qnprifir domain nroriurt nwnprl hv 

customer, for which the technical contact id is the technical contact for 
the specific product. 


WSPResponse 


lookupIndividualAccount ( ) 




Retrieves a list of all individual accounts linked to a wholesaler. 


WSPResponse 


lookupIndividualAccount (Properties optionalAttributes) 




Retrieves a list of all individual accounts linked to a wholesaler. 


WSPResponse 


lookupIndividualAccount (String pCustomerAccountld, 




String pCustomerPassword) 

Retrieves details of a specific individual customer account. 


WSPResponse 


lookupIndividualAccount (String pCustomerAccountld, 




String pCustomerPassword, Properties optionalAttributes) 

Retrieves details of a specific individual customer account. 


WSPResponse 


lookupTechnicalContact (Strinq pTechContactld) 




Retrieves details of a specific technical contact. 


WSPResponse 


lookupTechnicalContact (String pTechContactld, 




Properties optionaiAt-criouces; 

Retrieves details ot a specific tecnnicai contact. 


WSPResponse 


modif yBusinessAccount (String pCustomerAccountld, 




String pCustomerPassword) 

i nis meinou is useu to moony one or more aiiriuuiea ui aii 
existing business (organization) customer account. 


WSPResponse 


modif yBusinessAccount (String pCustomerAccountld, 




String pCustomerPassword, Properties optionalAttributes) 

I nis metnoQ is usee to moony one or more annuuies ot an 
existing business (organization) customer account. 


WSPResponse 


modifyDomain (String pCustomerAccountld, String plspPassword, 




String pDomainName, String aTechContactld) 

This method allows an Internet Service Provider (ISP) to modify 
the Technical uontact Id ot a specific domain product. 


WSPResponse 


modifyDomain (Strinq pCustomerAccountld, String plspPassword, 




String pDomainName, String aTechContactld, 
Properties optionalAttributes) 

This method allows an Internet Service Provider (ISP) to modify 
the Technical Contact Id of a specific domain product. 
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WSPResponse 


xnodifyDoxnain (String pCustomerAccountld, 




String pCustomerPassword, String pDomainName, String aHostldl, 
String aHostId2, String aTechContactld) 

This method allows a customer to modify one or more attributes 
associated with a specific instance of a Domain product registered to 
that customer. 


WSPResponse 


modifyDoma in (String pCustomerAccountld, 




String pCustomerPassword, String pDomainName, String aHostldl. 
String aHostId2, String aTechContactld, 
Properties optionalAttributes) 

This method allows a customer to modify one or more attributes 
associated with a specific instance of a Domain product registered to 
that customer. 


WSPResponse 


modifyDomain (String pCustomerAccountld, String pTechContactld, 




String pTechContactPassword, String pDomainName, 

String aHostldl, String aHostId2, String aTechContactld) 

This method allows a technical contact of a customer's domain 
product to modify one or more attributes associated with that specific 
instance of the Domain product registered to that customer. 


WSPResponse 


modifyDomain (String pCustomerAccountld, String pTechContactld, 




String pTechContactPassword, String pDomainName, 

String aHostldl, String aHostId2, String aTechContactld, 

Properties optionalAttributes) 

This method allows a technical contact of a customer's domain 
product to modify one or more attributes associated with that specific 
instance of the Domain product registered to that customer. 


WSPResponse 


modifyDomain (String pCustomerAccountld, 




String pCustomerPassword, String pDomainName, 

String aHostNamel, String aHostAddrl, String aHostName2, 

String aHostAddr2 f String aTechContactld) 

This method allows a customer to modify one or more attributes 
associated with a specific instance of a Domain product registered to 
that customer. 


WSPResponse 


modifyDomain (String pCustomerAccountld, 




String pCustomerPassword, String pDomainName, 

String aHostNamel, String aHostAddrl, String aHostName2, 

String aHostAddr2, String aTechContactld, 

Properties optionalAttributes) 

This method allows a customer to modify one or more attributes 
associated with a specific instance of a Domain product registered to 
that customer. 


WSPResponse 


modifyDomain (String pCustomerAccountld, String pTechContactld, 




String pTechContactPassword, String pDomainName, 

String aHostNamel, String aHostAddrl, String aHostName2, 

String aHostAddr2, String aTechContactld) 

This method allows a technical contact of a customer's domain 
product to modify one or more attributes associated with that specific 
instance of the Domain product registered to that customer. 



- 17- 



WO 01/20484 



PCT/US00/25305 



WSPResponse 


modifyDomain(Strinq pCus tome r Ac count Id, String pTechContactld. 




String pTechContactPassword, String pDomainName, 
Strinq aHostNamel, String aHostAddrl, String aHostName2 , 
String aHostAddr2, String aTechContactld, 
Properties optionalAttributes) 

This method allows a technical contact of a customer's domain 
proouct to moony one or more aunuuicb dbbuuiaicu wiui uidi specinc 
instance of the Domain product registered to tnat customer. 


WSPResponse 


modifylndividualAccount (String pCustomerAccountld, 




String pCustomer Pas sword) 

1 nis memou is usgu iu rnouiiy uiic ur muit? aunuuitJo ui ai\ 
existing individual customer account. 


WSPResponse 


modifylndividualAccount (String pCustomerAccountld, 




String pCustomerPassword, Properties optionalAttributes) 

I nis metnoa is useo to moaiiy one or more auriDuies or an 
existing individual customer account. 


WSPResponse 


modifyPassword (String pCustomerAccountld, 




String aCustomerPassword) 

I nis metnoo is usea to moony/reset a customer 5 accouni 
password. 


WSPResponse 


modifyPassword (String pCustomerAccountld, 




String aCustomerPassword, Properties optionalAttributes) 

This metnoo is used to mooiry/reset a customers account 
• 

password. 


WSPResponse 


modifyTechnicalContact (String pTechContactld, 




String pTechContactPassword) 

I nis metnoo is useo to moaiiy one or more aiinuuieb 01 an 
existing technical contact. 


WSPResponse 


modifyTechnicalContact (String pTechContactld, 




String pTechContactPassword, Properties optionalAttributes) 

This method is used to modify one or more attributes of an 
existing technical contact. 


warRCBpuiioc 


emit ( ) 

This method terminates the wholesaler's access to session 
commands. 


WSPResponse 


qui u V riOpci Llca vJ^J L. ± vjllct L. i_j.xuul.co/ 

This method terminates the wholesaler's access to session 
commands. 


void 


snutuown \ j 

This method shutsdown the Wholesaler Services Protocol API. 


WSPResponse 


verifyDomainName (String pDomainName) 




This method verifies whether or not a specified domain name is 
available. 


WSPResponse 


verifyDomainName (String pDomainName, 




Properties optionalAttributes) 
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This method verifies whether or not a specified domain name is 
available. 


WSPResponse 


verifyDomains (String pDomainTarget) 




This method verifies if series of domains are available. 


WSPResponse 


verifyDomains (String pDomainTarget, 




Properties optionalAttributes) 

This method verifies if series of domains are available. 


WSPResponse 


verifyPassword (String pCustomerAccountld, 




String pCustomerPassword) 

1 1 HO IMCUIUU VCIMICo VVIItHIICI Ul 1 IUI a OfJCUIllCU UUoLUI 1 Icl 

account id and password are valid. 


WSPResponse 


verifyPassword (String pCustomerAccountld, 




String pCustomerPassword, Properties optionalAttributes) 

This method verifies whether or not a specified customer 
account id and password are valid. 



Methods inherited from class iava.lanq. Object 

equals , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait 



The WSPResponse class represents the various components of a WSP response. A 
WSPResponse will be returned for command request that are issued through the application 
program interface 14. The response will describe, in as much detail as possible, the result of the 
issued request, and will optionally include any additional information that was generated by the 
request. A result consists of a "result code" followed by a descriptive "result message." The result 
code consists of a major result code followed by a period (7), followed by a minor result code. 

The three-digit major result code provides a general indication of the success or failure of 
an issued request. In most cases, one or more result properties are returned. The three-digit minor 
result code may provide additional information about the major result code. Each command 
request has its own set of minor result code values or may have the value (000). The 
WSPResponse and the result code are described in more detail in the aforementioned copending 
U.S. Patent Application Serial No. 09/544,305. A result property consists of a property key 
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followed by a colon (':'), followed by a property value. In some results, plain text is returned (e.g. 
information returned from the Help command). The result property is described in more detail in 
the aforementioned copending U.S. Patent Application Serial No. 09/544,305. The class definition 
for WSPResponse includes the following: 

5 



Constructor Summary 

WSPResponse ( String data) 

Parses a WSP text response and extracts and stores the various components. 



Method Summary 


static void 


displayResponse (WSPResponse response) 

prints debug-type representation of the WSP Response to 

ctanHcsrH r»iitniif 
oldllUdiU UUlfJUl 


static String 


get JdkVersion ( ) ' 
OlallC dUCcbbUr IIiUllivJU IU vjcl JUi\ VcioKJll 


int 


getMajorResultCode ( ) 

returns the WSP response major result code 


int 


getMinorResultCode ( ) 

returns the WSP response minor result code 


Properties 


getProperties ( ) 

Returns a property list containing all result property 
specifications, if applicable, extracted from the original WSP text 
response. 


static Properties 


getProperties (WSPResponse wspResponse) 




Returns a property list containing all result property 
specifications, if applicable, extracted from the original WSP text 
response. 


String 


getProperty (String resultPropertyKey) 

returns the result property value corresponding to the 
specified result property key, if found, extracted from the original 
WSP text response. 


String 


getRawResponse ( ) 

Returns the original WSP text response string used to 
instantiate object. 


String 


getResultCode ( ) 

returns the WSP response result code 


String 


getResultCodeAndMessage ( ) 
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returns the WSP response result code and result message 


String 


getResultMessage () 

Returns the result message extracted from the original WSP 
text response. 


static long 


getSerialVersion ( ) 

Static accessor method to get serial version 


Vector 


getText ( ) 

returns a vector containing lines of text returned in the WSP 
response. 


static double 


getVersionO 

Static accessor method to get release version 


String 


toStringO 

returns the raw WSP response 



Methods inherited from class javaJang.Object 

equals , getClass , hashCode , notify , notifyAll , wait , wait , wait 



The NSIWholesaleException class is a user-defined exception class denoting a special error 
thrown by the methods in the class NSIWholesaleAPI. In particular, exceptions of the class 
NSIWholesaleException are thrown (a) when class initialization fails; (b) when a method in 
NSIWholesaleAPI is called without successfully initializing the class; (c) when a command cannot 
be completed (for example due to communications problems); or (d) to reframe an NSIException 
thrown at a lower level to give additional context information. 

The class WSPExcept ion is the parent for wholesale protocol exception classes which 
processes responses sent by Wholesale Server 16 to computer application program 12. This is a 
service class, not used explicitly. It furnishes the base methods for storing error information 
common to all exception classes. 

The classes InvalidArgumentException and InvalidResponseFormatException are the 
detail class children of WSPException. Both methods have the same internal functionality as 
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WSPExcepton. In addition, both classes are independent, so that methods receiving the thrown 
exceptions know the type of error detected, even if the error context information is identical. In 
particular, the WSPResponse class throws InvalidArgumentException if the data returned by 
Wholesale Server 16 as part of a command, is invalid. The WSPResponse class throws class 
5 InvalidResponseFormatException if the data returned by the Wholesale Server 16 as part of a 

command, is not properly formatted. The class definition for NSIWholesaleException includes 
the following: 



Constructor Summary 


NSIWholesaleException ( ) 




NSIWholesaleException (String message) 




NSIWholesaleException (Strinq message, Throwable throwable) 




NSIWholesaleException (Throwable throwable) 





Method Summary 


static String 


get JdkVersion ( ) 

Static accessor method to get JDK version 


static long 


getSerialVersion ( ) 

Static accessor method to get serial version 


static double 


getVersion ( ) 

Static accessor method to get release version 


String 


toStringO 



10 

Methods inherited from class java.lang. Throwable 

f illlnStackTrace , getLocalizedMessage , getMessage , printStackTrace , 
printStackTrace , printStackTrace 
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Methods i nherited from class java.lang. Object 

equals , getClass , hashCode, notify , notifyAll , wait , wait , wait 



The class definition for WSPException includes the following: 



Constructor Summary 


WSPException { ) 




WSPException (String message) 


WSPException (String message, Throwable x) 





5 



Method Summary 


static String 


get JdkVersion ( ) 

Static accessor method to get JDK version 


String 


getMessage ( ) 


static long 


getSerialVersion ( ) 

Static accessor method to get serial version 


static double 


getVersion ( ) 

Static accessor method to get release version 



Methods inherited from class java.lang. Throwable 

f illlnStackTrace , getLocalizedMessage , pr intStackTrace , printStackTrace , 
printStackTrace , toString 



Methods inherited from class java.lanq. Object 

equals , getClass , hashCode , notify , notifyAll , wait , wait , wait 



1 0 The class definition for InvalidArgumentException is as follows: 



Constructor Summary 




InvalidArgumentException ( ) 
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InvalidArgumentException (String message) 




InvalidArgumentException (String message, Throwable x) 









Method Summary 


static String 


QetJdkVersionO 

Static accessor method to get JDK version 


String 


getMessageO 


static long 


getSerialVersion ( ) 

Static accessor method to get serial version 


static double 


getVersionO 

Static accessor method to get release version 



Methods inherited from class java.lang. Throwable 

fill InS tackTrace , getLocalizedMessage , printStackTrace , pr intStackTrace , 
printStackTrace , toString 



Methods inherited from class java.lang.Object 

equals , getClass , hashCode , notify , notifyAll , wait , wait, wait 



The class definition for InvalidResponseFormatException includes the following: 



Constructor Summary 




InvalidResponseFormatException ( ) 




InvalidResponseFormatException (String message) 




InvalidResponseFormatException (String message, Throwable x) 





Method Summary 



static String get JdJcVersion ( ) 
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Static accessor method to get JDK version 


String 


getMessage ( ) 


static long 


getSerialVersion ( ) 

Static accessor method to get serial version 


static double 


getVersionO 

Static accessor method to get release version 



Methods inherited from class java.lanq. Throwable 

f illlnStackTrace , getLocalizedMessage , pr intStackTrace , printStackTrace , 
print StackTrace , toString 



Methods inherited from class java.lang.Object 

equals , getClass , hashCode , notify , notifyAll , wait , wait , wait 



The invention will be further clarified by the following example showing a computer 
program file for creating a session with a Wholesale system to begin Wholesale operation, which is 
intended to be purely exemplary of the invention. 



777 ; 

* Copyright <c) 2000 Network Solutions, Inc <BR> 

* 

* This class is a demonstration program for use case 1: Creating a session 

* with NSI to begin wholesale operations. 
* 

* This class assumes the existance of the file WSPjavaAPI . conf , which was set 

* up in running the installation test earlier. 
* 

*<BR> -<BR> 

*/ 

// Imports 

import java.util.*; 

import java.io.*; 

import nsi .wholesale . toolkit . javaapi .util . resourcepool . * ; 

import nsi .wholesale . toolkit .javaapi . * ; 

// 

class NSIUseCasel 

{ 

//-- - - - - 

public static void main (String args [] ) 
{ 

NSIWholesaleAPI api = null; 

// Use the properties from the configuration file to establish a session 
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try { 

NSIWholesaleAPI . init ( "WSPj avaAPI . conf " ) ; 
} 

catch (NSIWholesaleException e) 
{ 

System. out .print ("Unable to initialize NSI Wholesale API:" + e) ; 

System. exit (1) ; 

} 

//Having initialized the NSI Wholesale API , we now need to 

// create an instance of the API by calling constructor NSIWholesaleAPI ( ) 

try { 

api = new NSIWholesaleAPI () ; 

} 

catch (NSIWholesaleException e) 
{ 

System. out .print ("Unable to initialize NSI Wholesale API:" + e) ; 

System. exit (1) ; 

} 

// 

// At this point, if no error has been thrown, then the session 
// is established, and a number of connections have been opened 
// in the connection pool . 
// 

// 

// Here, the call to methods on "api" are used to perform 

// wholesale related activities. For this use case, 

// there are none. 

// 

// End the session. This is done by calling the shutdown method on the 
// instance of the wholesale API that was created earlier, 
api . shutdown () ; 
} 

} 



The WSP Java API 14 is an implementation of the WSP, In every case where the WSP 
Java API 14 is used, the first steps are to initialize a session and then create an instance of the class 
to reference the methods. Individual calls to methods are instances of a single protocol exchange. 
Each call contains all necessary information (e.g., customer identification, contact information). 
Except for session information, no information carries over from method to method. 

As the example shows, the first evocation of a routine in the WSP Java API 14 is to the 
class method NSIWholesaleAPI.init to initialize the interface to the Wholesale System 16. The 
second evocation, creates an instance of the class NSIWholesaleAPI, which makes available to the 
application program 12 the methods to send commands to the Wholesale System 16. The 
application program 12 can now send command requests to the application program interface 14. 
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The last evocation is to the shutdown method, which ends the session with the Wholesale System 
16. 

It is to be noted that in the above description, references to Network Solutions, Inc. and 
NSI, including but not limited to references which are imbedded in the examples given of classes, 
methods, constructors, drawings, and the like, are intended to be exemplary only and not restricted 
to any particular implementation. 

While the foregoing description is based on a client-server architecture, those skilled in the 
art will recognize that other types of architecture may be used consistent with the invention. In 
addition, while the foregoing description is based on a software implementation, other . 
implementations may be used consistent with the invention. Further, while the foregoing 
description is based on the Java language, those skilled in the art will recognize that other types of 
language may be used consistent with the invention. Therefore, it is intended that this invention 
not be limited to the particular implementation and method disclosed herein, but that the invention 
include all implementations falling within the scope of the appended claims. 

The foregoing description is presented for illustration and explanation. It is not intended to 
be exhaustive or to limit the invention to the precise form disclosed, and modifications of 
variations are possible in light of the above teachings or may be acquired from practice of the 
invention. The principles of the invention and its practical application enable one skilled in the art 
to utilize the invention in various embodiments and with various modifications as are suited to the 
use contemplated. 

The class definition for NSIWholesaleAPI is as follows: 

// 

// Package 

// " 

package nsi . wholesale . toolkit . javaapi ; 
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// 

// Imports. . . 

// - 

5 import java . io. LineNumber Reader ; 

import java . io. FileReader ; 
import java . io. IOExcept ion; 
import java. io. FileNotFoundException; 
import java.util . StringTokenizer ; 
10 import java . util . Properties ; 

import java.util .Enumeration; 

import java .util . NoSuchElement Except ion; 

import nsi . wholesale . toolkit . j avaapi . ut il . resourcepool . Resource ; 

import nsi . wholesale . toolkit . j avaapi . util . resourcepool . ResourceException; 

15 

/** 

* Copyright (c) 2000 Network Solutions, Inc 

<BR> 

20 

* This Java-based Wholesale Services Protocol (WSP) API provides 

* programmer access to the Wholesale Services Protocol Server. 

* The Wholesale Services Protocol (WSP) is a simple, connection-based, 

* ASCII text-based protocol. It allows wholesalers to securely and 
25 * reliably create, modify, and lookup customer accounts and various 

* products via a single client/server interface. 
★ 

*<BR> 

30 <BR> 

* $Log$ 

*<BR> 

<BR> 
*/ 

35 public class NSIWholesaleAPI 

{ 

// — - 

// Beginning of Required/ Standard Fields 

// 

40 /** Serial Version */ 

static long serialVersion = 1L; 

/** Release Version */ 
static double version = 1.1D; 

45 

/** SCCS control ID */ 

static final String sccsID "©(#) wholesale-sdk_dl . 12 . 1 . 3 08/04/00 
10:27:19 NSIWholesaleAPI . java NSI" ; 

50 /** JDK Version */ 

static String jdkVersion = "1.1.7"; 

// Static Accessor Method (s) . . . 

/** Static accessor method to get serial version */ 
55 static public long getSerialVersion ( ) { return serialVersion; } 

/** Static accessor method to get release version */ 
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static public double getVersionO { return version; } 

/** Static accessor method to get JDK version */ 
static public String get JdkVersion ( ) { return jdkVersion; } 
5 // 

// End of Required/Standard Fields 

// 

// 

10 // class (static) variable (s) ... 

// . - - 

/** The name of this class */ 

private static final String className = "NSIWholesaleAPI" ; 

15 /** Connection pool */ 

protected static NSIWholesalePool pool = null; 



20 



/** Retry count */ 

protected static int retry = 1; 



// Supported Commands 

//- 

/** Ease-of-use constant for Command: Session */ 
public static final String COMMANDOS ESS ION = "Session"; 

25 /** Ease-of-use constant for Command: Describe */ 

public static final String COMMAND_DESCRIBE = "Describe"; 
/-** Ease-of-use constant for Command: Verify */ 
public static final String COMMAND_VERIFY = "Verify"; 
/** Ease-of-use constant for Command: Create */ 

30 public static final String COMMAND_CREATE = "Create"; 

/** Ease-of-use constant for Command: Delete */ 
public static final String COMMAND_DELETE = "Delete"; 
/** Ease-of-use constant for Command: Modify */ 
public static final String COMMAND_MODI FY = "Modify"; 

35 /** Ease-of-use constant for Command: Renew */ 

public static final String COMMAND_RENEW = "Renew"; 
/** Ease-of-use constant for Command: Generate */ 
public static final String COMMAND_GENERATE = "Generate"; 
/** Ease-of-use constant for Command: Lookup */ 

40 public static final String COMMAND_LOOKUP = "Lookup"; 

/** Ease-of-use constant for Command: Help */ 
public static final String COMMAND_HELP = "Help"; 
/** Ease-of-use constant for Command: Quit */ 
public static final String COMMAND_QU I T = "Quit"; 

45 

// Supported Classes 

// 

/** Ease-of-use constant for Class: DomainName */ 

public static final String CLASS_DOMAIN_NAME = "DomainName"; 

50 /** Ease-of-use constant for Class: Domains */ 

public static final String CLASS__DOMAINS = "Domains"; 
/** Ease-of-use constant for Class: Password */ 
public static final String CLASS_PASSWORD = "Password"; 
/** Ease-of-use constant for Class: IndividualAccount */ 

55 public static final String CLASS_INDIVIDUAL_ACCOUNT = 

"IndividualAccount"; 

/** Ease-of-use constant for Class: BusinessAccount */ 
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public static final String CLASS_BUSINESS_ACCOUNT = "BusinessAccount '» ; 
/** Ease-of-use constant for Class: TechnicalContact */ 

public static final String CLASSJTECHNlCAL_CONTACT = "TechnicalContact"; 
/** Ease-of-use constant for Class: Domain */ 
5 public static final String CLASS_DOMAIN = "Domain"; 

/** Ease-of-use constant for Class: DnsHosting */ 

public static final String CLASS_DNS_HOSTING = "DnsHosting"; 

// Supported Command -Class Combinations 

10 // 

/** Ease-of-use constant for Command-Class Combination: Verif yDomainName 

*/ 

public static final String COMBO_VERIFYJDOMAIN_NAME = COMMAND_VERIFY + " 
» + CLASS_DOMAIN_NAME; 
15 /** Ease-of-use constant for Command-Class Combination: Verify Domains 

*/ 

public static final String COMBO_VERIFY_DOMAINS = COMMAND_VERIFY + » « + 
CLASSJDOMAINS ; 

/** Ease-of-use constant for Command-Class Combination: Verify Password 

20 */ 

public static final String COMBO_VERIFY_PAS SWORD = COMMAND_VERIFY + " " 
+ CLASS_PASSWORD; 

/** Ease-of-use constant for Command-Class Combination: Create 
25 individualAccount */ 

public static final String COMBO_CREATE_INDIVIDUAL_ACCOUNT = 
COMMAND_CREATE + " " + CLASS_INDIVIDUAL_ACCOUNT; 

/** Ease-of-use constant for Command-Class Combination: Create 
BusinessAccount */ 

30 public static final String COMBO_CREATE_BUSINESS_ACCOUNT = 

COMMAND_CREATE + " " + CLASS_BUSINESS_ACCOUNT; 

/** Ease-of-use constant for Command-Class Combination: Create 
TechnicalContact */ 

public static final String COMBO_CREATE__TECHNICAL_CONTACT = 
35 COMMAND_CR EATE +'««'+ CLASS_TECHNICAL_CONTACT; 

/** Ease-of-use constant for Command-Class Combination: Create Domain */ 
public static final String COMBO_CREATE_DOMAIN = COMMAND__CREATE + " " + 
CLASSJX)MAIN; 

/** Ease-of-use constant for Command-Class Combination: Create 
40 DnsHosting */ 

public static final String COMBO_CREATE_DNS_HOSTING = COMMAND_CREATE + " 
" + CLASS_DNS_HOSTING; 

/** Ease-of-use constant for Command-Class Combination: Delete Domain */ 
45 public static final String COMBO_DELETE_DOMAIN = COMMANDJDELETE + » " + 

CLASS_DOMAIN; 

/** Ease-of-use constant for Command-Class Combination: Delete 
DnsHosting */ 

public static final String COMBO_DELETE_DNS_HOSTING = COMMANDED ELETE + " 
50 " + CLASS_DNS_HOSTING; 

/** Ease-of-use constant for Command-Class Combination: Delete 
IndividualAccount */ 

public static final String COMBOJDELETE_INDIVIDUAL_ACCOUNT = 
COMMAND_DELETE + " " + CLASS_INDIVIDUAL_ACCOUNT; 
55 /** Ease-of-use constant for Command-Class Combination: Delete 

BusinessAccount */ 
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public static final String COMBO_DELETE_BUSINESS_ACCOUNT = 
COMMAND_DELETE + " " + CLASS_BUSINESS_ACCOUNT; 

/** Ease-of-use constant for Command-Class Combination: Modify Domain */ 
5 public Static final String C0MBO_MODIFY_DOMAIN = COMMAND_MOD I FY + » « + 

CLASS_DOMAIN; 

/** Ease-of-use constant for Command-Class Combination: Modify 
IndividualAccount */ 

public static final String C0MB0_MODIFY_INDIVIDUAL_ACCOUNT = 
10 COMMAND_MOD I FY + '» » + CLASS_INDIVIDUAL_ACCOUNT; 

/** Ease-of-use constant for Command-Class Combination: Modify 
BusinessAccount */ 

public static final String COMBO_MODIFY_BUSINESS_ACCOUNT = 
COMMAND_MOD I FY + « " + CLASS_BUSINESS_ACCOUNT; 
15 /** Ease-of-use constant for Command-Class Combination: Modify 

TechnicalContact */ 

public static final String COMBO_MODI FY_TECHNICAL_CONTACT = 
COMMAND_MOD I FY + " » + CLAS S__TECHN I CAL — CONTACT ; 

/** Ease-of-use constant for Command-Class Combination: Modify Password 

20 */ 

public static final String C0MB0_MODIFY_PAS SWORD = COMMAND_MOD I FY + " 
+ CLASSJPASSWORD; 

/** Ease-of-use constant for Command-Class Combination: Renew Domain */ 
25 public static final String C0MB0_RENEW_DOMAIN = COMMAND_RENEW + " " + 

CLASS_DOMAIN; 

/** Ease-of-use constant for Command-Class Combination: Renew DnsHosting 

*/ 

public static final String COMBO_RENEW_DNS_HOSTING = COMMAND_RENEW + » " 
30 + CLASS_DNS_HOSTING; 

/** Ease-of-use constant for Command-Class Combination: Generate 
DomainName */ 

public static final String COMBO_G ENE RAT E_DOMA I N_N AM E = COMMAND_GENERATE 
35 + " " + CLASS J30MAIN_NAME; 

/** Ease-of-use constant for Command-Class Combination: Lookup Domain */ 
public Static final String COMBO_LOOKUP_DOMAIN = COMMAND_LOOKUP + " « + 
CLASS_DOMAIN; 

40 /** Ease-of-use constant for Command-Class Combination: Lookup 

DnsHosting */ 

public static final String COMBO_LOOKUP_DNS_HOSTING = COMMAND_LOOKUP + " 
«■ + CLASSJDNS_HOSTING; 

/** Ease-of-use constant for Command-Class Combination: Lookup 
45 IndividualAccount */ 

public static final String COMBO_LOOKUP_INDIVIDUAL_ACCOUNT = 
COMMAND JjOOKUP + " " + CLASS_INDIVIDUAL_ACCOUNT; 

/** Ease-of-use constant for Command-Class Combination: Lookup 
BusinessAccount */ 

50 public static final String COMBO_LOOKUP_BUSINESS_ACCOUNT = 

COMMAND_LOOKUP + » " + CLASS_BUSINESS_ACCOUNT; 

/** Ease-of-use constant for Command-Class Combination: Lookup 
TechnicalContact */ 

public static final String COMBO_LOOKUP_TECHNICAL_CONTACT = 
55 COMMAND_LOOKUP + " " + CLASS_TECHNICAL_CONTACT; 

// Supported Attributes 
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// 

/** Ease-of-use constant for Attribute Key: FirstName */ 

public static final String ATTR_FIRST_NAME = "FirstName"; 

/** Ease-of-use constant for Attribute Key: LastName */ 
5 public static final String ATTR_L AS T_NAM E = "LastName"; 

/** Ease-of-use constant for Attribute Key: Addressl */ 

public static final String ATTR_ADDRESS1 = "Addressl"; 

/** Ease-of-use constant for Attribute Key: Address2 */ 

public static final String ATTR_ADDRESS2 = "Address2"; 
10 /** Ease-of-use constant for Attribute Key: Address3 */ 

public static final String ATTR_ADDRESS3 = "Address3"; 

/** Ease-of-use constant for Attribute Key: Address4 */ 

public static final String ATTR_ADDRE SS 4 = "Address4"; 

/** Ease-of-use constant for Attribute Key: Address5 */ 
15 public static final String ATTR_ADDRESS5 = "AddressS"; 

/** Ease-of-use constant for Attribute Key: City */ 

public static final String ATTR_CITY = "City"; 

/** Ease-of-use constant for Attribute Key: State */ 

public static final String ATTR_STATE = "State"; 
20 /** Ease-of-use" constant for Attribute Key: PostalCode */ 

public static final String ATTR_POSTAL_CODE = "PostalCode"; 

/** Ease-of-use constant for Attribute Key: Count ryCode */ 

public static final String ATTR_COUNTRY_CODE = "CountryCode" ; 

/** Ease-of-use constant for Attribute Key: Phone */ 
25 public static final String ATTR_PHONE = "Phone"; 

/** Ease-of-use constant for Attribute Key: Fax */ 

public static final String ATTR__ FAX = "Fax"; 

/** Ease-of-use constant for Attribute Key: Email */ 

public static final String ATTR_EMAIL = "Email"; 
30 /** Ease-of-use constant for Attribute Key: CustomerAccountld */ 

public, static final String ATTR_CUSTOMER_ACCOUNT_ID = 
" CustomerAccountld" ; 

/** Ease-of-use constant for Attribute Key: CustomerPassword */ 

public static final String ATTR_CUSTOMER_ PAS SWORD = "CustomerPassword"; 
35 /** Ease-of-use constant for Attribute Key: AuthQuestion */ 

public static final String ATTR_AUTH_QUESTION = "AuthQuestion"; 

/** Ease-of-use constant for Attribute Key: AuthAnswer */ 

public static final String ATTR_AUTH_ANSWER = "AuthAnswer"; 

/** Ease-of-use constant for Attribute Key: CompanyName */ 
40 public static final String ATTR_COMPANY_NAME = "CompanyName"; 

/** Ease-of-use constant for Attribute Key: CompanyType */ 

public static final String ATTR_COMPANY_TYPE = "CompanyType"; 

/** Ease-of-use constant for Attribute Key: LegalContactFirstName */ 

public static final String ATTR_LEGAL_CONTACT_FIRST_NAME = 
45 "LegalContactFirstName"; 

/** Ease-of-use constant for Attribute Key: LegalContactLastName */ 

public static final String ATTR_LEGAL_CONTACT_LAST_NAME = 
"LegalContactLastName" ; 

/** Ease-of-use constant for Attribute Key: LegalContactAddressl */ 
50 public static final String ATTR_LEGAL_C0NTACT_ADDRESS1 = 

"LegalContactAddressl" ; 

/** Ease-of-use constant for Attribute Key: LegalContactAddress2 */ 

public static final String ATTR_LEGAL_C0NTACT_ADDRESS2 = 
"LegalContactAddress2" ; 
55 /** Ease-of-use constant for Attribute Key: LegalContactAddress3 */ 

public static final String ATTR_LEGAL_CONTACT_ADDRES S 3 = 
"LegalContactAddress3 " ; 
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/** Ease-of-use constant for Attribute Key: LegalContactAddress4 */ 
public static final String ATTR_LE GAL_CONTACT_ADDRE S S 4 = 
"LegalContactAddress4 " ; 

/** Ease-of-use constant for Attribute Key: LegalContactAddressS */ 
5 public static final String ATTR_LEGAL_CONTACT_ADDRESS5 « 

"LegalContactAddressS" ; 

/** Ease-of-use constant for Attribute Key: LegalContactCity */ 

public static final String ATTR_L EG AL_CONTACT_C I TY = "LegalContactCity"; 

/** Ease-of-use constant for Attribute Key: LegalContactState */ 

10 public static final String ATTR_LEGAL_CONT ACT_S TATE = 

"LegalContactState" ; 

/** Ease-of-use constant for Attribute Key: LegalContactPostalCode */ 
public static final String ATTR__LEGAL_C0NTACT_POSTAL_CODE = 
"LegalContactPostalCode" ; 

15 /** Ease-of-use constant for Attribute Key: LegalContactCountryCode */ 

public static final String ATTR__LEGAL__CONTACT_COUNTRY_CODE = 
"LegalContactCountryCode" ; 

/** Ease-of-use constant for Attribute Key: LegalContactPhone */ 
public static final String ATTR_LEGAL_CONTACT_PHONE = 

20 "LegalContactPhone"; 

/** Ease-of-use constant for Attribute Key: LegalContactFax */ 
public static final String ATTR_LEGAL_CONTACT_FAX = "LegalContactFax"; 
/** Ease-of-use constant for Attribute Key: LegalContactEmail */ 
public static final String ATTR__LEGAL_CONTACT_EMAIL = 

25 "LegalContactEmail" ; 

/** Ease-of-use constant for Attribute Key: Organization */ 
public static final String ATTR_ORGAN I Z AT I ON = "Organization"; 
/** Ease-of-use constant for Attribute Key: TechContactPassword */ 
public static final String ATTR_TECH_CONTACT_P AS SWORD = 

30 "TechContactPassword" ; 

/** Ease-of-use constant for Attribute Key: DomainName */ 
public static final String ATTR_DOMAIN_NAME = "DomainName"; 
/** Ease-of-use constant for Attribute Key: HostNamel */ 
public static final String ATTR_H0ST_NAME1 = "HostNamel"; 

35 /** Ease-of-use constant for Attribute Key: HostAddrl */ 

public static final String ATTR_H0ST_ADDR1 = "HostAddrl"; 
/** Ease-of-use constant for Attribute Key: HostName2 */ 
public static final String ATTR_HOST_NAME2 - "HostName2"; 
/** Ease-of-use constant for Attribute Key: HostAddr2 */ 

40 public static final String ATTR_HOST_ADDR2 = "HostAddr2"; 

/** Ease-of-use constant for Attribute Key: Hostldl */ 
public static final String ATTR_H0ST_ID1 = "Hostldl"; 
/** Ease-of-use constant for Attribute Key: HostId2 */ 
public static final String ATTR_HOST_ID2 = "HostId2"; 

45 /** Ease-of-use constant for Attribute Key: TechContactld */ 

public static final String ATTR_TECH_CONTACT_ID = "TechContactld"; 
/** Ease-of-use constant for Attribute Key: IspPassword */ 
public static final String ATTR^I S P_PAS SWORD = " IspPassword" ; 
/** Ease-of-use constant for Attribute Key: Protocol (returned by 

50 Describe) */ 

public static final String ATTR_PROTOCOL = "Protocol"; 
/** Ease-of-use constant for Attribute Key: Dns Hosting Created 
(returned by Create DnsHosting) */ 

public static final String ATTR_DNS_HOS T I NG — CREATED = "Dns Hosting 

55 Created"; 

// Supported Parameters 
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// - 

/** Ease-of-use constant for Parameter Key: -WholesalerAccountld */ 
public static final String PARM_WHOLESALER_ACCOUNT_ID = 

WholesalerAccountld" ; 
5 /** Ease-of-use constant for Parameter Key: -WholesalerPassword */ 

public static final String PARM__WHOLESALER_PASSWORD = »- 

WholesalerPassword" ; 

/** Ease-of-use constant for Parameter Key: -Target */ 
public static final String PARM_TARGET = "-Target"; 
10 /** Ease-of-use constant for Parameter Key: -DomainTarget */ 

public static final String PARM_DOMAIN_TARGET = "-DomainTarget"; 
/** Ease-of-use constant for Parameter Key: -Keywords */ 
public static final String PARM_KEY_WORDS = "-Keywords"; 
/** Ease-of-use constant for Parameter Key: -CustomerAccountld */ 
15 public static final String PARM_CUSTOMER_ACCOUNT_ID = »-» + 

ATTR_CUSTOMER_ACCOUNT_ID ; 

/** Ease-of-use constant for Parameter Key: -CustomerPassword */ 
public static final String PARM_CUSTOMER_PAS SWORD = + 

ATTR_CUSTOMER_PASSWORD ; 
20 /** Ease-of-use constant for Parameter Key: -DomainName */ 

public static final String PARM_DOMAIN_NAME = "-" + ATTR_DOMAIN_NAME; 
/** Ease-of-use constant for Parameter Key; -TechContactld */ 
public static final String PARMJTECH_CONTACT_ID = •■-» + 

ATTRJTECH_CONTACT_ID; 
25 /** Ease-of-use constant for Parameter Key: -TechContactPassword */ 

public static final String PARMJTECH_CONTACT_PAS SWORD = "-" + 

ATTR__TECH_CONTACT_PAS SWORD ; 

/** Ease-of-use constant for Parameter Key: -IspPassword */ 

public static final String PARM_ISP_P AS SWORD = "-" + ATTR__I SP_P AS SWORD; 

30 

// 

// class (static) method(s) . . . 

// - 

35 /** 

* Initializes the Wholesale Services Protocol API. 
★ 

* ©param String name of configuration files containing property list 

* ©return void 

40 * ©see NSIWholesaleAPI#init 

* ©exception nsi . wholesale . toolkit . javaapi .NSlWholesaleException if 
initialization fails 

*/ 

public static void init (String conf igFileName) 
45 throws NSlWholesaleException { 

System. out .print In ( "NSIWholesaleAPI . init (String) started" ) ; 
Properties configProps = new Properties () ; 
try { 

LineNumberReader in = new LineNumberReader (new 
50 FileReader (conf igFileName) ) ,- 

String line = in. readLine ( ) ; 
while (line != null) { 

line = line.trimO; 

if ( (line. length () > 0) && (line. startsWith ( "#" ) == 

55 false) ) { 

try { 
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StringTokenizer st - new 

StringTokenizer (line, " = ") ; 

String propertyKey = st .nextToken ( ) ; 
String propertyValue = st . nextToken () ; 
5 conf igProps.put (propertyKey, 

propertyValue) ; 

} 

catch (NoSuchElementException nsee) { 

10 System. err. print In ( "NSIWholesaleAPI . init (String) : Error Reading Config 

File" + nsee) ; 

throw new NSIWholesaleExcept ion ( "Error 
reading Configuration File " + conf igFileName) ; 

} 

15 } 

line = in.readLine () ; 

} } 

20 catch (FileNotFoundException fnfe) { 

System. err .print In ( "NSIWholesaleAPI .init (String) : 
Configuration File Not Found 11 + fnfe) ; 

throw new NSIWholesaleException ( "Conf iguration File Not 
Found " + conf igFileName) ; 
25 } 

catch (IOException ioe) { 

System. err . print In ( "NSIWholesaleAPI . init ( String) : 10 
Exception reading configuration file " + ioe) ; 

throw new NSIWholesaleException (" 10 Exception reading 
30 configuration file " + conf igFileName) ; 

} 

catch (Exception e) { 

System. err. println ( "NSIWholesaleAPI . init (String) : Exception 
reading configuration file " + e) ; 
35 throw new NSIWholesaleException ( "Exception reading 

configuration file " + conf igFileName) ; 
} 



40 



NSIWholesaleAPI . init (conf igProps) ; 

System. out .print In ( "NSIWholesaleAPI . init (String) completed 
successfully" ) ; 
} 

45 /** 

* Initializes the Wholesale Services Protocol API. 

* <BR> 

* All of the following parameters should be 

* passed in through the properties file: 
50 <PRE> 

WholesaleAPI .minConnections - 

Connections to use on startup (1,2,5, 10) 

WholesaleAPI .maxConnect ions - 

Maximum Connections (5,10,20) 
55 WholesaleAPI .connect ionSoTimeout - (Provided by NSI) 

Enable/disable Socket S0_TIMEOUT with the specified 

timeout, in milliseconds 
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WholesaleAPI .connectionProtocol - (Provided by NSI) 

Wholesale Services Protocol Version 
WholesaleAPI .server - (Provided by NSI) 

The secure wholesale server at NSI 
5 WholesaleAPI. port - (Provided by NSI) 

The port on that machine 
WholesaleAPI .retry - 

The retry count, if a transient error occurs (2,3) 

10 WholesaleAPI . WholesalerAccount Id - (Provided by NSI) 

The Wholesaler Account number 
WholesaleAPI .WholesalerPassword - (Provided by NSI) 
The Password for that account 

</PRE> 

15 

* ©param properties Properties, file containing configuration settings 

* ©return void 

* ©see NSIWholesaleAPI#NSIWholesaleAPI 

* ©exception nsi . wholesale . toolkit . javaapi .NSIWholesaleException if 
20 initialization fails 

*/ 

public static void init (Properties properties) 
throws NSIWholesaleException { 

System. out .print In ( "NSIWholesaleAPI .init (Properties) started") ; 
25 int min = parselnt ( 

properties .get Property ( "WholesaleAPI .minConnections" ) ) ; 
int max = parselnt ( 

properties .getProperty ( "WholesaleAPI .maxConnections" ) ) ; 
int connectionSoTimeout » parselnt ( 
30 properties .getProperty ("WholesaleAPI .connectionSoTimeout" ) ) ; 

String connectionProtocol = 
properties . getProperty ( "WholesaleAPI . connectionProtocol " ) ; 

String server = properties .getProperty ( "WholesaleAPI . server " ) ; 
int port = parselnt (properties. getProperty ( "WholesaleAPI . port") ) ; 
35 retry = parselnt (properties . getProperty ( "WholesaleAPI . retry" )) ; 

String WholesalerAccount Id = 

properties .getProperty ( "WholesaleAPI . WholesalerAccountld" ) ; 
String WholesalerPassword = 
40 properties .getProperty ( "WholesaleAPI . WholesalerPassword" ) ; 



System, out .println( "connectionProtocol = " + connectionProtocol); 
System. out . print In ("server = " + server); 
45 System. out .println( "port = " + port); 

System. out ,println( "WholesalerAccountld = " + 
WholesalerAccountld) ; 

System. out .println( "WholesalerPassword = " + WholesalerPassword); 
System. out .println( "NSIWholesaleAPI . init (Properties) constructing 
50 new NSIWholesalePool"); 

pool = new NSIWholesalePool (server, port, min, max, 

WholesalerAccountld, WholesalerPassword, retry, 
connectionSoTimeout) ; 

NSIWholesaleAPI api = new NSIWholesaleAPI 0 ; 
55 if (api. verifyConnectionProtocol (connectionProtocol) != true) 

{ 

api = null; 
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throw new NSIWholesaleException ( "Failed to verify connection 
protocol " + connectionProtocol) ; 

} 

api = null; 

Sys tern. out .print In ("NSIWholesaleAPI . init (Properties) completed 
successfully") ; 
} 



//- 

// static initializer block . . . 

// 

// - " 

// instance Variable (s) ... 

// 

// 

// Constructor (s) 

// 

/** 

* Constructs a new NSIWholesaleAPI object. NSIWholesaleAPI MUST have 

* been initialized BEFORE any NSIWholesaleAPI objects can be 
constructed. 

* ©see NSIWholesaleAPItfinit 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException if 
NSIWholesaleAPI has not yet 

* been initialized 

*/ 

public NSIWholesaleAPI () throws NSIWholesaleException { 
if (pool == null) 

throw new NSIWholesaleException ( "Must initialize API before 

use" ) ; 

} 

// 

// Accessors and Mutators 

// 



// 

// General Methods 

// 

//#- -BEGIN API 



J * * 

* This method is used to authenticate a wholesaler and to provide 

* the wholesaler with access to Session commands. Once a session 

* has been established, the Session command may not be issued 

* again 

* <BR><PRE> 

Expected Major Result Code: SESSION_CREATED 

* </PRExBR> 

* ©param pWholesalerAccountld the parameter value 

* ©param pWholesalerPassword the parameter value 

* ©return the Wholesale Server Protocol Server response 
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* ©exception nsi . wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see COMMAND_SESSION 

* ©see PARM_WHOLESALE_ACCOUNT_ID 

* ©see PARM_WHOLE SAL E__PAS SWORD 

* ©see WSPResponse#SESSION_CREATED 

* ©see WSPResponse#AUTHENTICATION_FAILED 
* 

*/ 

WSPResponse session ( 

String pWholesalerAccountld, 

String pWholesalerPassword) 
throws NSIWholesaleException { 

return session ( pWholesalerAccountId f pWholesalerPassword, new 
Properties 0 , 0) ; 
} 

/** 

* This method is used to authenticate a wholesaler and to provide 

* the wholesaler with access to Session commands. Once a session 

* has been established, the Session command may not be issued 

* again 

* <BRxPRE> 

Expected Major Result Code: SESSION_CREATED 

* </PRExBR> 

* ©param pWholesalerAccountld the parameter value 

* ©param pWholesalerPassword the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the wholesale Server 'Protocol Server response 

* ©exception nsi . wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see COMMAND_SESSION 

* ©see PARM_WH0LESALE_ACCOUNT_ID 

* ©see PARM_WHOLESALE_PASSWORD 

* ©see WSPResponse#SESSION_CREATED 

* ©see WS PRe spons e #AUTHENT I CAT ION_FAI LED 

*/ 

WSPResponse session ( 

String pWholesalerAccountld, 
String pWholesalerPassword, 
Properties optionalAttributes) 
throws NSIWholesaleException { 

return session ( pWholesalerAccountld, pWholesalerPassword, 
optionalAttributes, 0) ; 

} 

protected WSPResponse session ( 

String pWholesalerAccountld, 
String pWholesalerPassword, . 
Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + " . session (String, String, 
Properties, int) " ; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 
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10 



15 



NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool .checkout () ; 
Properties allParmsAndAttrs = new Properties 0 ,- 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

allParmsAndAttrs . put ( PARM_WHOLESALER_ACCOUNT_ID, 
pWholesalerAccountld) ; 

allParmsAndAttrs .put (PARM_WHOLESALER_P AS SWORD, 
pWholesalerPassword) ; 



returnCode = conn .make Request (COMMAND_S ESS ION, 

allParmsAndAttrs) ,- 

pool .checkln (conn) ; 
return returnCode; 
20 } catch (Exception e) { 

try { 

pool . release (conn) ; 

} 

catch (ResourceException re) { 
25 System. err. print In (methodName + "Caught 

ResourceException" + re) ; 

} 

finally { 

return session { 

30 pWholesalerAccountld, 

pWholesalerPassword, 
optionalAttributes , 
count + 1) ; 

} 

35 } 
} 

* This method provides information about a specified target. 
40 * Currently, the only supported target is "Protocol". 

* This target tells Describe to return the current protocol version 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
45 Expected Result Property Key(s) Returned: 

ATTR_PR0TOCOL 

* </PRExBR> 

* ©param pTarget the parameter value 

* ©return the Wholesale Server Protocol Server response 

50 * ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleExcept ion when 

unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_DESCRIBE 

* ©see NSIWholesaleAPI#PARM_TARGET 

* ©see NSIWholesaleAPI#ATTR_PROTOCOL 
55 * ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
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*/ 

public WSPResponse describe (String pTarget) 
throws NSIWholesaleException { 

return describe (pTarget, new Properties () , 0); 

} 

/** 

* This method provides information about a specified target. 

* Currently, the only supported target is "Protocol". 

* This target tells Describe to return the current protocol version 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned; 
ATTR_PROTOC0L 

* </PRExBR> 

* ©param pTarget the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale, toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_DESCRIBE 

* ©see NS I Who 1 e sa 1 e AP I # PARM_TARGET 

* ©see NSIWholesaleAPI#ATTR_PROTOCOL 

* ©see 

WSPResponse#C0MMAND_EXECUTION_SUCCEEDED_PR0PERTIES_BEING - RETURNED 
* 

*/ 

public WSPResponse describe (String pTarget, Properties 
optionalAttributes) 

throws NSIWholesaleException { 

return describe (pTarget , optionalAttributes, 0) ; 

} 

protected WSPResponse describe ( 
String pTarget, 

Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + ". describe (String, Properties, 

int) "; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool .checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 
allParmsAndAttrs .put ( PARMJTARGET , pTarget) ; 
returnCode = conn . makeRequest (COMMAND_DESCRIBE , 

allParmsAndAttrs) ; 
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pool .checkln( conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

} 

catch (ResourceException re) { 

System. err. print In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return describe ( 
pTarget , 

optionalAttributes , 
count + 1) ; 

} 

) 

} 

/** 

* This method verifies whether or not a specified domain name is 
available . 

* <BR><PRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* </PRExBR> 

* ©param pDomainName the parameter value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_VERIFY 

* ©see NSIWholesaleAPI#CLASS_DOMAIN_NAME 

* ©see NSIWholesaleAPI#COMBO_VERIFY_DOMAIN_NAME 

* ©see NSlWholesaleAPI#PARM_DOMAIN_NAME 

* ©see WSPReSpOnse#COMMAND_EXECUTI0N_SUCCEEDED_N0_DATA_BEING_RETURNED 
*/ 

public WSPResponse verifyDomainName ( 

String pDomainName) 
throws NSIWholesaleException { 
return verifyDomainName ( 
pDomainName, 
new Properties () , 
0); 

} 

/** 

* This method verifies whether or not a specified domain name is 
available . 

* <BR><PRE> 

Expected Major Result Code: 
COMMAND__EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* </PRExBR> 

* ©param pDomainName the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi . wholesale . toolkit . javaapi . NSIWholesaleException when 
unable to complete command 
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* ©see NSIWholesaleAPI#COMMAND_VERIFY 

* ©see NSIWholesaleAPI#CLASS_DOMAIN_NAME 

• * ©see NSIWholesaleAPI#COMBO_VERIFY_DOMAIN_NAME 

* ©see NSIWholesaleAPI#PARM_DOMAIN_NAME 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 
★ 

*/ 

public WSPResponse verif yDomainName ( 
String pDomainName, 
Properties optionalAttributes) 
throws NSIWholesaleException { 
return verif yDomainName ( 
pDomainName, 
optionalAttributes , 
0) ; 

} 

protected WSPResponse verif yDomainName ( 
String pDomainName, 
Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + " .verif yDomainName (String , 
Properties, int) " ; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn - null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool . checkout () ,■ 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 
allParmsAndAttrs .put (PARM_DOMAIN_NAME, pDomainName) ; 
returnCode = conn . make Request (COMBO__VERIFY_DOMAIN_NAME , 

allParmsAndAttrs) ; 

pool. checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

} 

catch (ResourceException re) { 

System. err. print In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return verif yDomainName { 
pDomainName, 
optionalAttributes , 
count + 1) ; 

} 
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} 

} 

J ** 

5 * This method verifies if series of domains are available. The command 

* will take the domain target string and add the .com, .net, and .org 

* TLD suffix and verify the domain name availability. 

* <BRxPRE> 

Expected Major Result Code: 
10 COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEINGJ*ETURNED 

Expected Result Property Key(s) Returned: 
DomainNamel : 
DomainName2 : 
DomainName3 : 
15 . . .etc. . . 

* </PRExBR> 

* ©param pDomainTarget the parameter value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi . wholesale . toolkit . javaapi .NSIWholesaleExcept ion when 
20 unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_VERIFY 

* ©see NSIWholesaleAPI#CLASS_DOMAINS 

* ©see NSIWholesaleAPI#COMB0_VERIFY_D0MAINS 

* ©see NSI Who 1 e s a 1 e AP I # P ARM_D0MA IN_T ARG ET 

25 * ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* ©see 

WSPResponsetfCOMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
* 

*/ 

30 public WSPResponse verif yDomains ( 

String pDomainTarget) 
throws NSIWholesaleException { 
return verif yDomains ( 
pDomainTarget , 
35 new Properties () , 

0) ; 

} 

/** 

* This method verifies if series of domains are available. The command 
40 * will take the domain target string and add the .com, .net, and .org 

* TLD suffix and verify the domain name availability. 

* <BRxPRE> 

Expected Major Result Code: 
COMMANDJEXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
45 Expected Result Property Key(s) Returned: 

DomainNamel : 
DomainName2 : 
DomainName3 : 
. . . etc . . . 
50 * </PRExBR> 

* ©param pDomainTarget the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi . wholesale . toolkit . javaapi .NSIWholesaleException when 
55 unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_VERIFY 

* ©see NSIWholesaleAPI#CLASS DOMAINS 
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* ©see NSIWholesaleAPI#COMBO_VERIFY_DOMAINS 

* ©see NSIWholesaleAPI#PARM_DOMAINJTARGET 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* ©see 

5 WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
* 

*/ 

public WSPResponse verif yDomains ( 
String pDomainTarget, 
10 Properties optionalAttributes) 

throws NSIWholesaleException { 
return verif yDomains ( 
pDomainTarget, 
optionalAttributes, 
15 0); 
} 

protected WSPResponse verif yDomains ( 
String pDomainTarget, 
Properties optionalAttributes, 
20 int count) 

throws NSIWholesaleException { 

String methodName = className + " .verif yDomains (String, 
Properties, int) "; 

if (count > retry) { 

25 throw new NSIWholesaleException (methodName + "Unable to 

complete command"); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

30 

try { 

conn = (NSIWholesaleConnection) pool . checkout () ,- 
Properties allParmsAndAttrs = new Properties () ; 

35 // put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

allParmsAndAttrs .put ( PARM_DOMAIN_TARGET , pDomainTarget) ; 

40 returnCode ■ conn .makeRequest (COMBO_VERIFY_DOMAINS , 

allParmsAndAttrs) ; 

pool . checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
45 try { 

pool. release (conn) ; 

} 

catch (ResourceException re) { 

System, err .println (methodName + "Caught 
50 ResourceException" + re) ; 

} 

finally { 

return verif yDomains ( 
pDomainTarget , 

55 optionalAttributes, 

count + 1) ; 

} 
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} 

} 

I * * 

* This method verifies whether or not a specified customer account id 

and 

* password are valid. 

* <BRxPRE> 

Expected Major Result Code: 
COMM7^ID - EXECUTION_SUCCEEDED_NO - DATA_BEING_RETURNED 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pCustomerPassword the parameter value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi . wholesale . toolkit . javaapi . NSIWholesaleExcept ion when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_VERIFY 

* ©see NSIWholesaleAPI#CLASS_PASSWORD 

* ©see NSIWholesaleAPI#COMBO_VERIFY__PASSWORD 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUST0MER_PASSWORD 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 
* 

*/ 

public wSPResponse verif yPassword { 
String pCustomerAccountld, 
String pCustomerPassword) 
throws NSIWholesaleException { 
return verif yPassword ( 

pCustomerAccountld, 
pCustomerPassword, 
new Properties () , 
0) ; 

} 

/** 

* This method verifies whether or not a specified customer account id 

and 

* password are valid. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_NO__DATA_BEING_RETURNED 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pCustomerPassword the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_VERIFY 

* ©see NSIWholesaleAPI#CLASS_PASSWORD 

* ©see NSIWholesaleAPI#COMBO_VERIFY_PASSWORD 

* ©see NSIWholesaleAPI#PARM_CUSTOMER__ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_OJSTOMER_PASSWORD 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 
* 

*/ 

public WSPResponse verif yPassword ( 
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String pCustomerAccountld, 
String pCustomer Pas sword, 
Properties optionalAttributes) 
throws NSIWholesaleException { 
return verif yPassword ( 

pCustomerAccountld , 

pCustomer Password , 

optionalAttributes , 

0); 

} 

protected WSPResponse verif yPassword ( 
String pCustomerAccountld, 
String pCustomerPassword, 
Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + " .verif yPassword (String, String, 
Properties, int) " ; 

- if -(count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn ■ null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool . checkout () ; 
Properties allParmsAndAttrs - new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs , optionalAttributes) ; 

allParmsAndAttrs .put (PARM_CUSTOMER_ACCOUNT_ID, 
pCustomerAccountld) ; 

allParmsAndAttrs .put (PARM_CUS TOME REPASS WORD, 
pCustomerPassword) ; 

returnCode = conn.makeRequest (COMBO_VERIFY_PASSWORD, 

allParmsAndAttrs) ; 

pool . checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

} 

catch (ResourceException re) { 

System, err .print In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return verif yPassword ( 

pCustomerAccount Id , 
pCustomerPassword , 
optionalAttributes, 
count + 1) ; 

} 

} 
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} 



/** 

5 * This method creates an individual customer account and returns an 

* automatically generated customer account id. 

* <BR><PRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
10 Expected Result Property Key(s) Returned: 

ATTR_CUSTOMER_ACC0UNT_ID 

* </PRExBR> 

* ©param aFirstName the attribute value 

* ©param aLastName the attribute value 
15 * ©param aAddressl the attribute value 

* ©param aCountryCode the attribute value 

* ©param aPhone the attribute value 

* ©param aCustomerPassword the attribute value 

* ©param aAuthQuestion the attribute value 
20 * ©param aAuthAnswer the attribute value 

* ©param aCity the attribute value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

25 * ©see NS I Who 1 e s a 1 e AP I # COMMAND_CRE ATE 

* ©see NSIWholesaleAPI#CLASS_INDIVIDUAL_ACCOUNT 

* ©see NSIWholesaleAPI#COMBO_CREATE_INDIVIDUAL_ACCOUNT 

* ©see NS I Whol e sal e AP I # ATTR_FI RST_NAME 

* ©see NS I Whol e s a 1 e AP I # ATTR_LAST_NAME 
30 * ©see NSIWholesaleAPI#ATTR_ADDRESSl 

* ©see NSIWholesaleAPI#ATTR_COUNTRY__CODE 

* ©see NSIWholesaleAPI#ATTR_PHONE 

* ©see NSIWholesaleAPI#ATTR_CUSTOMER_PASSWORD 

* ©see NSIWholesaleAPI#ATTR_AUTHj2UESTION 
35 * ©see NSIWholesaleAPI#ATTR_AUTH_ANSWER 

* ©see NSIWholesaleAPI#ATTR_CITY 
* 

* ©see NS I Who 1 e s a 1 e AP I # ATTR^S TAT E 

* ©see NSIWholesaleAPI#ATTR_POSTAL_CODE 
40 * ©see NSIWholesaleAPI#ATTR_ADDRESS2 

* ©see NSIWholesaleAPI#ATTR_ADDRESS3 

* ©see NSIWholesaleAPI#ATTR_ADDRESS4 

* ©see NSIWholesaleAPI#ATTR_ADDRESS5 

* ©see NSI Wholesale API # ATTR_EMA I L 
45 * ©see NSIWholesaleAPI#ATTR_FAX 

* 

* ©see WSPResponse#INVALID_VALUE 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
50 * ©see NSIWholesaleAPI#ATTR_CUSTOMER_ACCOUNT_ID 

* 

*/ 

public WSPResponse createlndividualAccount ( 
String aFirstName, 
55 String aLastName, 

String aAddressl, 
String aCountryCode, 
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String aPhone, 
String aCustomer Password, 
String aAuthQuestion, 
String aAuthAnswer, 
String aCity) 
throws NSIWholesaleException { 

return createlndividualAccount { 

aFirstName, 

aLastName, 

aAddressl , 

aCountryCode, 

aPhone, 

aCustomerPassword, 
aAuthQuestion, 
aAuthAnswer, 
aCity, 

new Properties ( ) , 
0); 

} 

I * * 

* This method creates an individual customer account and returns an 

* automatically generated customer account id. 

* <BRxPRE> 

Optional Attribute Key(s) : 
ATTR_ADDRESS2 
ATTR_ADDRESS3 
ATTR_ADDRESS4 
ATTR_ADDRESS5 
ATTR_EMAIL 
ATTR_FAX 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
ATTR_CUSTOMER_ACCOUNT_ID 

* </PRExBR> 

* ©param aFirstName the attribute value 

* ©param aLastName the attribute value 

* ©param aAddressl the attribute value 

* ©param aCountryCode the attribute value 

* ©param aPhone the attribute value 

* ©param aCustomerPassword the attribute value 

* ©param aAuthQuestion the attribute value 

* ©param aAuthAnswer the attribute value 

* ©param aCity the attribute value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi . wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NS I Who 1 e s a 1 e AP I # COMMAND_CRE ATE 

* ©see NSIWholesaleAPI#CLASS_INDIVIDUAL_ACCOUNT 

* ©see NSIWholesaleAPI#COMBO_CREATE_INDIVIDUAL_ACCOUNT 

* ©see NS I Who 1 e sa 1 e AP I # ATTR_FI RST_NAME 

* ©see NS I Who 1 e sa 1 eAP I #ATTR_LAS T_NAME 

* ©see NS I Who 1 e s a 1 eAP I # ATTR_ADDRESS 1 

* ©see NSIWholesaleAPI#ATTR_COUNTRY_CODE 

* ©see NSIWholesaleAPI#ATTR PHONE 
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NSIWholesaleAPI#ATTR POSTAL CODE 



WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
* ©see NSIWholesaleAPI#ATTR_CUSTOMER_ACCOUNT__ID 
* 

20 */ 

public WSPResponse createlndividualAccount ( 
String aFirstName, 
String aLastName, 
String aAddressl, 
25 String aCountryCode , 

String aPhone, 
String aCustomerPassword, 
String aAuthQuestion, 
String aAuthAnswer, 
30 String aCity, 

Properties optionalAttributes) 
throws NSIWholesaleException { 

return createlndividualAccount ( 
aFirstName, 
35 aLastName, 

aAddressl, 
aCountryCode, 
aPhone, 

aCustomerPassword , 
40 aAuthQuestion, 

aAuthAnswer, 
aCity, 

optionalAttributes , 
0) ; 

45 } 

protected WSPResponse createlndividualAccount ( 

String aFirstName, 

String aLastName, 

String aAddressl, 
50 String aCountryCode, 

String aPhone, 

String aCustomerPassword, 

String aAuthQuestion, 

String aAuthAnswer, 
55 String aCity, 

Properties optionalAttributes, 

int count) 
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throws NSIWholesaleException { 

String methodName = classNarne + 
" . createlndividualAccount (StringX9, Properties, int) " ; 
if (count > retry) { 

5 throw new NSIWholesaleException (methodName + "Unable to 

complete command 1 '); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

10 

try { 

conn = (NSIWholesaleConnection) pool. checkout 0 ; 
Properties allParmsAndAttrs = new Properties () ; 

15 // put optional attributes 

propertiesCat (allParmsAndAttrs , optionalAttributes) ; 

allParmsAndAttrs . put (ATTR_FIRST_NAME , aFirstName) ; 
allParmsAndAttrs . put ( ATTR_LAST_NAME , aLastName) ; 
20 allParmsAndAttrs . put (ATTR_ADDRESS1 , aAddressl) ; 

allParmsAndAttrs . put ( ATTR_COUNTRY_CODE , aCountryCode) ; 
allParmsAndAttrs . put ( ATTR_PHONE , aPhone) ; 
allParmsAndAttrs .put (ATTR_CUSTOMER_P AS SWORD, 
aCustomerPas sword) ; 

25 allParmsAndAttrs . put (ATTR_AUTH_QUESTION / aAuthQuestion) ; 

allParmsAndAttrs . put (ATTR_AUTH_ANSWER , aAuthAnswer ) ; 
allParmsAndAttrs .put (ATTR_CITY, aCity) ; 

returnCode = 

30 conn . makeRequest (COMBO^CREATE^INDIVIDUA^ACCOUNT, allParmsAndAttrs) ; 

pool . checkln (conn) ; 
return returnCode; 

} 

catch (Exception e) { 
35 try { 

pool . release (conn) ; 

} 

catch (ResourceException re) { 

System. err .println (methodName + "Caught 
40 ResourceException" + re) ; 

} 

finally { 

return createlndividualAccount ( 
aFirstName, 

45 aLastName, 

aAddressl , 
aCountryCode, 
a Phone, 

aCustomerPas sword, 
50 aAuthQuestion, 

aAuthAnswer, 
aCity, 

optionalAttributes , 
count + 1) ; 

55 } 

} 
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I it ft 

* This method creates an individual customer account and returns an 

* automatically generated customer account id. 
5 * <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
ATTR_CUSTOMER_ACCOUNT_ID 
10 * </PRExBR> 

* ©param aFirstName the attribute value 

* ©par am aLastName the attribute value 

* ©param aAddressl the attribute value 

* ©param aCountryCode the attribute value 
15 * ©param aPhone the attribute value 

* ©param aCustomerPassword the attribute value 

* ©param aAuthQuestion the attribute value 

* ©param aAuthAnswer the attribute value 

* ©param aCity the attribute value 
20 * ©param aState the attribute value 

* ©param aPostalCode the attribute value 

* ©return the wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

25 * ©see NSI Whole saleAPI#COMMAND_CREATE 

* ©see NSIWholesaleAPI#CLASS_INDIVIDUAL_ACCOUNT 

* ©see NSIWholesaleAPI#COMBO_CREATE_INDIVIDUAL_ACCOUNT 

* ©see NS I Who lesaleAPI # ATTR_F I RST_NAME 

* ©see NSIWholesaleAPI#ATTR_LAST_NAME 
30 * ©see NSIWholesaleAPI#ATTR_ADDRESSl 

* ©see NS I Whol e s a 1 e AP I # ATTR_COUNTR Y_CODE 

* ©see NSIWholesaleAPI#ATTR_PHONE 

* ©see NSIWholesaleAPI#ATTR_CUSTOMER_PASSWORD 

* ©see NSIWholesaleAPI#ATTR_AUTH_QUESTION 
35 * ©see NSIWholesaleAPI#ATTR_AUTH_ANSWER 

* ©see NSIWholesaleAPI#ATTR_CITY 

* ©see NSIWholesaleAPI#ATTR_STATE 

* ©see NSIWholesaleAPI#ATTR_POSTAL_CODE 
* 

40 * ©see NSIWholesaleAPI#ATTR_ADDRESS2 

* ©see NSIWholesaleAPI#ATTR_ADDRESS3 

* ©see NSIWholesaleAPI#ATTR_ADDRESS4 

* ©see NS I Who 1 e s a le AP I # ATTR_ADDRES S 5 

* ©see NSIWholesaleAPI#ATTR_EMAIL 
45 * ©see NSI Whole saleAPI#ATTR_FAX 

* 

* ©see WSPResponse#INVALID_VALUE 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
50 * ©see NSIWholesaleAPI#ATTR_CUSTOMER_ACCOUNT_ID 

*/ 

public WSPResponse createlndividualAccount ( 
String aFirstName, 
55 String aLastName, 

String aAddressl, 
String aCountryCode, 
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String aPhone, 
String aCustomer Password, 
String aAuthQuestion, 
String aAuthAnswer, 
5 String aCity, 

String aState, 
String aPostalCode) 
throws NSIWholesaleException { 

return createlndividualAccount ( 
10 aFirstName, 

aLastName, 
aAddressl, 
aCount ryCode , 
a Phone , 

15 aCustomerPassword, 

aAuthQuestion, 
aAuthAnswer, 
aCity, 
aState, 

20 aPostalCode, 

new Properties 0 , 
0); 

} 

/* * 

25 * This method creates an individual customer account and returns an 

* automatically generated customer account id. 

* <BR><PRE> 

Optional Attribute Key(s): 
ATTR_ADDRESS2 

30 ATTR_ADDRESS3 

ATTR_ADDRE S S 4 
ATTR_ADDRESS5 
ATTR_EMAIL 
ATTR_FAX 

35 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
ATTR_CUSTOMER_ACCOUNT_ID 
40 * </PRExBR> 

* ©param aFirstName the attribute value 
* * ©param aLastName the attribute value 

* ©param aAddressl the attribute value 

* ©param aCountryCode the attribute value 
45 * ©param aPhone the attribute value 

* ©param aCustomerPassword the attribute value 

* ©param aAuthQuestion the attribute value 

* ©param aAuthAnswer the attribute value 

* ©param aCity the attribute value 
50 * ©param aState the attribute value 

* ©param aPostalCode the attribute value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi . NSIWholesaleException when 
55 unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_CREATE 

* ©see NSIWholesaleAPI#CLASS INDIVIDUAL ACCOUNT 
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* ©see NSIWholesaleAPTttCOMBO_CREATE__INDIVIDUAL_ACCOUNT 

* ©see NS I Who 1 e sa 1 eAP I # ATTR_F I RST_NAME 

* ©see NSIWholesaleAPI#ATTR_LAST_NAME 

* ©see NSIWholesaleAPI#ATTR~ADDRESSl 

5 * ©see NSIWholesaleAPI#ATTR_COUNTRY_CODE 

* ©see NSIWholesaleAPI#ATTR_PHONE 

* ©see NSIWholesaleAPI#ATTR_CUSTOMER_PASSWORD 

* ©see NSIWholesaleAPI#ATTR_AUTH_QUESTION 

* ©see NSIWholesaleAPI#ATTR_AUTH_ANSWER 
10 * ©see NSIWholesaleAPi#ATTR~CiTY 

* ©see NSIWholesaleAPI#ATTR_STATE 

* ©see NSIWholesaleAPI#ATTR_POSTAL_CODE 
* 

* ©see NS I Whol e sal eAP I # ATTR_ADDRES S 2 
15 * ©see NS I Whol e sal eAP I # ATTR_ADDRES S 3 

* ©see NSIWholesaleAPI#ATTR_ADDRESS4 

* ©see NS I Whol e s a le AP I # ATTR_ADDRES S 5 

* ©see NS I Whol e sal eAP I # ATTR_EMAI L 

* ©see NSIWholesaleAPl#ATTR_FAX 

20 

* ©see WSPResponse#INVALID_VALUE 

* ©see 

WSPResponse#COMMAND_EXECUTION__SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see NSIWholesaleAPI#ATTR_CUSTOMER_ACCOUNT_ID 

25 

*/ 

public WSPResponse createlndividualAccount ( 
String aFirstName, 
String aLastName, 
30 String aAddressl, 

String aCountryCode, 
String aPhone, 
String aCustomerPassword, 
String aAuthQuestion, 
35 String aAuthAnswer, 

String aCity, 
String aState, 
String aPostalCode, 
Properties optionalAttributes) 
40 throws NSIWholesaleException { 

return createlndividualAccount ( 
aFirstName, 
aLastName, 
aAddressl, 

45 aCountryCode , 

a Phone , 

aCustomer Pas sword, 
aAuthQuestion, 
aAuthAnswer, 
50 aCity, 

aState, 
aPostalCode, 
optionalAttributes, 
0); 

55 } 

protected WSPResponse createlndividualAccount ( 
String aFirstName, 
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String aLastName, 
String aAddressl, 
String aCountryCode, 
String aPhone, 
5 String aCustomer Pas sword, 

String aAuthQuestion, 
String aAuthAnswer, 
String aCity, 
String aState, 
10 String aPostalCode, 

Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + 
15 " .createlndividualAccount (StringXll, Properties, int) " ; 

if (count > retry) ( 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} • 

20 NSIWholesaleConnection conn = null; 

WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool . checkout () ; 
25 Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs , optionalAttributes) ; 

30 allParmsAndAttrs. put (ATTR_FIRST_NAME, aFirstName) ; 

allParmsAndAttrs .put (ATTR_LAST_NAME, aLastName) ; 

allParmsAndAttrs .put (ATTR_ADDRESS1 , aAddressl) ; 

allParmsAndAttrs .put (ATTR_COUNTRY_CODE, aCountryCode) ; 

allParmsAndAttrs. put (ATTR_PHONE, aPhone) ; 
35 allParmsAndAttrs .put (ATTR_CUSTOMER_PASSWORD, 

aCustomerPassword) ; 

allParmsAndAttrs .put (ATTR_AUTH_QUESTION / aAuthQuestion) ; 

allParmsAndAttrs .put (ATTR_AUTH_ANSWER, aAuthAnswer) ; 

allParmsAndAttrs. put (ATTR__CITY, aCity) ; 
40 allParmsAndAttrs .put (ATTR_STATE, aState) ; 

allParmsAndAttrs .put (ATTR_P0STAL_CODE, aPostalCode) ; 

returnCode = 

conn.makeRequest (COMBO^CREATE^NDIVIDUAL^ACCOUNT, allParmsAndAttrs) ; 
45 pool . checkln ( conn) ; 

return returnCode; 

} 

catch (Exception e) { 
try { 

50 pool . release (conn) 

} 

catch (ResourceException re) { 

System. err. print In (methodName + "Caught 
ResourceException" + re) ; 
55 } 

finally { 

return createlndividualAccount ( 
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aFirstName, 
aLastName , 
aAddressl , 
aCountryCode, 
a Phone, 

aCustomer Pas sword , 
a Au t hQue s t i on , 
aAuthAnswer, 
aCity, 
aState, 
aPostalCode, 
optionalAttributes , 
count + 1) ; 

} 

} 

} 



/** 

* This method creates a business customer account and returns an 

* automatically generated customer account id. 

* <BR><PRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
ATTR_CUSTOMER_ACCOUNT_ID 

* </PRExBR> 

* ©param aCompanyName the attribute value 

* ©param aCompanyType the attribute value 

* ©param aAddressl the attribute value 

* ©param aCity the attribute value 

* ©param aCountryCode the attribute value 

* ©param aPhone the attribute value 

* ©param aCustomerPassword the attribute value 

* ©param aAuthQuestion the attribute value 

* ©param aAuthAnswer the attribute value 

* ©param aLegalContactFirstName the attribute value 

* ©param aLegalContactLastName the attribute value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale. toolkit . javaapi .NSIWholesaleExcept ion when 
unable to complete command 

* ©see NS I Whole sal eAP I # COMMAND_CREATE 

* ©see NSIWholesaleAPI#CLASS_BUSINESS_ACCOUNT 

* ©see NSIWholesaleAPI#COMBO_CREATE_BUSINESS_ACCOUNT 

* ©see NSIWholesaleAPI#ATTR_COMPANY_NAME 

* ©see NSIWholesaleAPI#ATTR_COMPANY_TYPE 

* ©see NSI Wholes ale API#ATTR_ADDRESS1 

* ©see NSIWholesaleAPI#ATTR_CITY 

* ©see NSIWholesaleAPI#ATTR_COUNTRY_CODE 

* ©see NSIWholesaleAPI#ATTR__PHONE 

* ©see NSIWholesaleAPI#ATTR_CUSTOMER_PASSWORD 

* ©see NSIWholesaleAPI#ATTR_AUTH_QUESTION 

* ©see NS I Whol e sal eAP I # ATTR_AUTH_ANS WER 

* ©see NS I Who lesaleAPI # ATTR_L EGAL_CONTACT_F I RS T_NAM E 

* ©see NS I Who 1 e s a 1 eAP I # ATTR_LEGAL_CONTACT_LAST_NAME 
* 

* ©see NSIWholesaleAPI#ATTR STATE 
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10 



15 



20 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES__BEING_RETURNED 

* ©see NSIWholesaleAPI#ATTR_CUSTOMER_ACCOUNT_ID 

25 

*/ 

public WSPResponse createBusinessAccount ( 
String aCompanyName , 
String aCompanyType , 
30 String aAddressl, 

String aCity, 
String aCountryCode, 
String aPhone, 
String aCustomerPassword, 
35 String aAuthQuestion, 

String aAuthAnswer, 
String aLegalContactFirstName, 
String aLegalContactLastName) 
throws NSIWholesaleException { 
40 return createBusinessAccount ( 

aCompanyName , 
aCompanyType , 
aAddressl , 
aCity , 

45 aCountryCode, 

aPhone , 

aCustomerPassword, 

aAuthQuestion, 

aAuthAnswer, 

50 aLegalContactFirstName, 

aLegalContactLastName , 
new Properties () , 
0); 

} 

55 /** 

* This method creates a business customer account and returns an 

* automatically generated customer account id. 
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* <BRxPRE> 

Optional Attribute Key(s) : 
ATTR_ADDRESS2 
ATTR_ADDRESS3 

5 ATTR_ADDRESS4 

ATTR__ADDRESS5 
ATTR_EMAIL 
ATTR_FAX 

ATTR_LEGAL_CONTACT_ADDRESS 1 
1 0 ATTR JjEGAL_CONTACT_ADDRESS2 

ATTR_LEGAL_CONTACT_ADDRESS 3 
ATTR_LEG AL_CONTACT_ADDRES S 4 
ATTR_LEGAL_CONTACT_ADDRES S 5 
ATTR_LEGAL_CONTACT_CITY 
1 5 ATTR_LEGAL_CONTACT~STATE 

ATTR_LEGAL_CONTACT_POSTAL_CODE 
ATTR_LEGAL_CONTACT_COUNTRY_CODE 
ATTR_LEGAL_CONTACT__PHONE 
ATTR_LEGAL_CONTACT_FAX 
20 ATTR LEGAL CONTACT EMAIL 



Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected- Result Property Key(s) Returned: 
25 ATTR__CUSTOMER_ACCOUNT_ID 

* </PRExBR> 

* ©param aCompanyName the attribute value 

* ©param aCompanyType the attribute value 

* ©param aAddressl the attribute value 
30 * ©param aCity the attribute value 

* ©param aCountryCode the attribute value 

* ©param aPhone the attribute value 

* ©param aCustomerPas sword the attribute value 

* ©param aAuthQuestion the attribute value 
35 * ©param aAuthAnswer the attribute value 

* ©param aLegalContactFirstName the attribute value 

* ©param aLegalContactLastName the attribute value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

40 * ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 

unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_CREATE 

* ©see NSIWholesaleAPI#CLASS_BUSINESS_ACCOUNT 

* ©see NSIWholesaleAPI#C0MB0_CREATE_BUSINESS_ACCOUNT 
45 * ©see NS I Who 1 e s a 1 e AP I # ATTR_COMPANY__NAME 

* ©see NS I Who 1 e sa 1 e AP I # ATTR_C0MP ANY__T Y PE 

* ©see NSIWholesaleAPI#ATTR_ADDRESSl 

* ©see NSIWholesaleAPI#ATTR_CITY 

* ©see NSIWholesaleAPI#ATTR_COUNTRY_CODE 
50 * ©see NSIWholesaleAPI#ATTR_PHONE 

* ©see NSIWholesaleAPI#ATTR_CUSTOMER_PASSWORD 

* ©see NSIWholesaleAPI#ATTR_AUTH_QUESTION 

* ©see NSIWholesaleAPI#ATTR_AUTH_ANSWER 

* ©see NSI Who lesaleAPI# ATTR_LEGAL_CONTACT_F I RS T_NAM E 
55 * ©see NSI Whole saleAPI#ATTR_LEGAL_CONTACT_LAST_NAME 

* 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_STATE 
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©see 



NS I Who lesaleAPI # ATTR_LEGAL_CONTACT_EMA I L 

20 



WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
* ©see NSIWholesaleAPI#ATTR_CUSTOMER_ACCOUNT_ID 

25 

*/ 

public WSPResponse createBusinessAccount ( 
String aCompanyName , 
String aCompanyType , 
30 String aAddressl, 

String aCity, 
String aCountryCode, 
String aPhone,- 
String aCustomerPas sword, 
35 String aAuthQuestion, 

String aAuthAnswer, 
String aLegalContactFirstName , 
String aLegalContactLastName, 
Properties optionalAttributes) 
40 throws NSIWholesaleException { 

return createBusinessAccount ( 
aCompanyName , 
aCompanyType , 
aAddressl, 
45 aCity, 

aCountryCode, 
aPhone, 

aCustomer Pas sword, 
aAuthQuestion, 
50 aAuthAnswer, 

aLegalContactFirstName , 
aLegalContactLastName, 
optionalAttributes, 
0); 

55 } 

protected WSPResponse createBusinessAccount ( 
String aCompanyName, 
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String aCompanyType , 
String aAddressl, 
String aCity, 
String aCountryCode, 
5 String aPhone, 

String aCustomerPassword, 
String aAuthQuestion, 
String aAuthAnswer, 
String aLegalContactFirstName , 
10 String aLegalContactLastName , 

Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + " . createBusinessAccount (StringXll , 
15 Properties, int) "; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

20 NSIWholesaleConnection conn = null; 

WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool .checkout () ; 
25 Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

30 allParmsAndAttrs .put (ATTR__COMPANY_NAME, aCompanyName) ; 

allParmsAndAttrs . put (ATTR_COMPANYJTYPE, aCompanyType) ; 
allParmsAndAttrs .put ( ATTR__ADDRESS1 , aAddressl) ; 
allParmsAndAttrs. put (ATTR_CITY, aCity) ; 
allParmsAndAttrs .put (ATTR_C0UNTRY_CODE, aCountryCode) ; 
35 allParmsAndAttrs .put (ATTR_PHONE, aPhone) ; 

allParmsAndAttrs .put (ATTR_CUSTOMER_PASSWORD, 
aCustomerPassword) ; 

allParmsAndAttrs. put (ATTR_AUTH_QUESTION, aAuthQuestion) ; 
allParmsAndAttrs .put (ATTR_AUTH_ANSWER, aAuthAnswer) ; 
40 allParmsAndAttrs .put ( ATTR_LEG AL_CONTACT_F I RS T_N AM E , 

aLegalContactFirstName) ; 

allParmsAndAttrs .put (ATTR_LEGAL_CONTACT_LAST_NAME, 
aLegalContactLastName) ; 

45 returnCode = conn. makeRequest (COMBO_CREATE_BUSINESS_ACCOUNT, 

allParmsAndAttrs) ; 

pool .checkln( conn) ; 
return returnCode; 
} catch (Exception e) { 
50 try { 

pool. release (conn) ; 

} 

catch (ResourceException re) { 

System. err .print In (methodName + "Caught 
55 ResourceException" + re) ; 

} 

finally { 
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return createBusinessAccount ( 
aCompanyName , 
aCompanyType , 
aAddressl, 

5 aCity, 

aCountryCode, 
aPhone, 

aCustomerPassword, 
aAuthQuestion, 
10 aAuthAnswer, 

aLegalContactFirstName , 
aLegalContactLastName , 
optionalAttributes , 
count + 1) ; 

15 } 



/** 

20 * This method creates a business customer account and returns an 

* automatically generated customer account id. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION - SUCCEEDED_PROPERTIES_BEING_RETURNED 
25 Expected Result Property Key(s) Returned: 

ATTRj:USTOMER_ACCOUNT_ID 

* </PRExBR> 

* ©param aCompanyName the attribute value 

* ©param aCompanyType the attribute value 
30 * ©param aAddressl the attribute value 

* ©param aCity the attribute value 

* ©param aState the attribute value 

* ©param aPostalCode the attribute value 

* ©param aCountryCode the attribute value 
35 * ©param aPhone the attribute value 

* ©param aCustomerPassword the attribute value 

* ©param aAuthQuestion the attribute value 

* ©param aAuthAnswer the attribute value 

* ©param aLegalContactFirstName the attribute value 
40 * ©param aLegalContactLastName the attribute value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSI Who 1 e s a 1 e AP I # COMMAND__CRE ATE 

45 * ©see NSIWholesaleAPI#CLASS_BUSINESS_ACCOUNT 

* ©see NSIWholesaleAPI#COMBO_CREATE_BUSINESS_ACCOUNT 

* ©see NS I Who 1 e sa 1 e AP I # ATTR_C0MP ANY_NAME 

* ©see NSIWholesaleAPI#ATTR_COMPANY_TYPE 

* ©see NSlWholesaleAPl#ATTR_ADDRESSl 
50 * ©see NSIWholesaleAPI#ATTR_CITY 

* ©see NSIWholesaleAPI#ATTR_STATE 

* ©see NSIWholesaleAPI#ATTR_POSTAL__CODE 

* ©see NSIWholesaleAPI#ATTR_COUNTRY_CODE 

* ©see NSIWholesaleAPI#ATTR_PHONE 

55 * ©see NSIWholesaleAPI#ATTR_CUSTOMER_PASSWORD 

* ©see NSIWholesaleAPI#ATTR_AUTH_QUESTION 

* ©see NSIWholesaleAPI#ATTR AUTH ANSWER 
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* ©see NS I Who lesaleAPI # ATTR_LEGAL_CONTACT_F I RST_NAME 

* ©see NS I Whol e s a 1 e AP I # ATTR_LEGAL__CONTACT_LAS T_NAM E 
* 

* ©see NS I Whol esaleAPI # ATTR_ADDRE S S 2 
5 * ©see NS I Whol e s a 1 e AP I # ATTR_ADDRESS 3 

* ©see NSIWholesaleAPI#ATTR_ADDRESS4 

* ©see NSIWholesaleAPI#ATTR_ADDRESS5 

* ©see NSIWholesaleAPI#ATTR_EMAIL 

* ©see NSIWholesaleAPIttATTR^FAX 

10 * ©see NS I Who lesaleAPI # ATTR_LEG AL_CONTACT__AD DR E SSI 

* ©see NS I Who 1 e S a 1 e AP I # ATTR_LEG AL_CONTACT_ADDRE S S 2 

* ©see NS I Who 1 e S a 1 eAP I # ATTR_LEGAL_CONTACT__ADD RE S S 3 

* ©see NS I Who 1 e sa 1 eAP I # ATTR_LEGAL_CONTACT_ADDRE S S 4 

* ©see NSIWholesal eAP I # ATTR_LEG AL_CONTACT_ADDRE S S 5 
15 * ©see NS I Who 1 e s a 1 eAP I # ATTR_LEGAL_CONTACT__C I TY 

* ©see NS I Who 1 e s a 1 eAP I # ATTR_LEG AL_CONTACT_STATE 

* ©see NS I Whole sal eAP I # ATTR_LEGAL_CONTACT__POSTAL_CODE 

* ©see NS I Who le sa 1 eAP I # ATTR_LEGAL_CONTACT__COUNTRY_CODE 

* ©see NS I Who 1 e sa 1 eAP I # ATTR_LEGAL_CONTACT_PHONE 
20 * ©see N S I Who lesaleAPI # ATTR_LEG AL_CONTACT_F AX 

* ©see NS I Who 1 e s a 1 eAP I # ATTR_LEGAL_CONTACT_EMAI L 
* 

* ©see WSPResponse#INVALID_VALUE 

* ©see 

25 WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see NSIWholesaleAPI#ATTR_CUSTOMER_ACCOUNT_ID 
* 

*/ 

public WSPResponse createBusinessAccount ( 
30 String aCompanyName , 

String aCompanyType, 
String aAddressl, 
String aCity, 
String aCountryCode, 
35 String aPhone, 

String aCustomerPassword, 
String aAuthQuestion, 
String aAuthAnswer, 
String aLegalContactFirstName, 
40 String aLegalContactLastName , 

String aState, 
String aPostalCode) 
throws NSIWholesaleException { 

return createBusinessAccount ( 
45 aCompanyName , 

aCompanyType , 
aAddressl , 
aCity, 

aCountryCode, 
50 aPhone , 

aCustomerPassword , 

aAuthQuestion, 

aAuthAnswer, 

aLegalContactFirstName , 
55 aLegalContactLastName, 

aState, 

aPostalCode, 
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new Properties () , 
0) ; 

} 

/** 

* This method creates a business customer account and returns an 

* automatically generated customer account id. 

* <BR><PRE> 

Optional Attribute Key(s) : 



ATTR_ 


ADDRESS 2 




ATTR] 


]ADDRESS3 




ATTR] 


]ADDRESS4 




ATTr] 


]ADDRESS5 




attr] 


]email 




attr] 


]fax 




attr" 


]legal_contact_ 


_ADDRESS1 


attr" 


]legal_contact] 


]ADDRESS2 


attr_ 


"legal contact^ 


]ADDRESS3 


attr] 


]legal_contact] 


]ADDRESS4 


attr_ 


]legal_contact] 


]ADDRESS5 


attr] 


]legal_contact] 


]CITY 


attr] 


]legal_contact] 


]STATE 


ATTR_ 


]legal_contact] 


]postal__code 


attr] 


]legal_contact] 


]C0UNTRY_C0DE 


ATTR_ 


legal_contact] 


]PHONE 


attr] 


]legal_contact] 


]fax 


ATTR_ 


]legal_contact] 


]email 



Expected Major Result Code: 
COMMAND_EXECUT I ON_SUCCE ED ED_PROPERT I ES__BEING_RETURNED 
Expected Result Property Key(s) Returned: 
ATTR_CUSTOMER_ACCOUNT_ID 

* </PRExBR> 

* ©param aCompanyName the attribute value 

* ©param aCompanyType the attribute value 

* ©param aAddressl the attribute value 

* ©param aCity the attribute value 

* ©param aState the attribute value 

* ©param aPostalCode the attribute value 

* ©param aCountryCode the attribute value 

* ©param aPhone the attribute value 

* ©param aCustomerPassword the attribute value 

* ©param aAuthQuestion the attribute value 

* ©param aAuthAnswer the attribute value 

* ©param aLegalContactFirstName the attribute value 

* ©param aLegalContactLastName the attribute value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale, toolkit .javaapi . NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesal e AP I # COMMAND_CRE ATE 

* ©see NSIWholesaleAPI#CLASS_BUSINESS_ACCOUNT 

* ©see NSIWholesaleAPI#COMBO_CREATE_BUSINESS_ACCOUNT 

* ©see NSIWholesaleAPI#ATTR_COMPANY_NAME 

* ©see NSIWholesaleAPI#ATTR_COMPANYJTYPE 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_ADDRE SSI 

* ©see NSIWholesaleAPI#ATTR_CITY 

* ©see NSIWholesaleAPI#ATTR_STATE 
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NSIWholesaleAPI#ATTR LEGAL CONTACT STATE 



10 



15 



20 



25 



30 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
* ©see NSIWholesaleAPI#ATTR_CUSTOMER_ACCOUNT_ID 
* 

*/ 

35 public WSPResponse createBusinessAccount ( 

String aCompanyName , 
String aCompanyType , 
String aAddressl, 
String aCity, 
40 String aCountryCode , 

String aPhone, 
String aCus tome r Pas sword, 
String aAuthQuestion, 
String aAuthAnswer, 
45 String aLegalContactFirstName, 

String aLegalContactLastName, 
String aState, 
String aPostalCode, 
Properties optionalAttributes) 
50 throws NSIWholesaleException { 

return createBusinessAccount ( 
aCompanyName, 
aCompanyType , 
aAddressl, 
55 aCity, 

aCountryCode, 
a Phone, 
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aCUstomer Pas sword , 

aAuthQuestion, 

aAuthAnswer, 

aLegalContactFirstName , 

aLegalContactLastName , 

aState, 

aPostalCode, 

optionalAttributes , 

0); 

} 

protected WSPResponse createBusinessAccount ( 

String aCompanyName, 

String aCompanyType , 

String aAddressl, 

String aCity, 

String aCountryCode, 

String aPhone, 

String aCustomerPassword, 

String aAuthQuestion, 

String aAuthAnswer, 

String aLegalContactFirstName, 

String aLegalContactLastName, 

String aState, 

String aPostalCode, 

Properties optionalAttributes, 

int count) 
throws NSIWholesaleException { 

String methodName = className + " . createBusinessAccount (StringX13 , 
Properties, int) "; 

if (count > retry) { 

throw new NSIWholesaleException (met hodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn - null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool. checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

allParmsAndAttrs .put ( ATTR_COMPANY_NAME , aCompanyName) ; 

allParmsAndAttrs . put ( ATTR_COMPANY_TYPE , aCompanyType ) ; 

allParmsAndAttrs. put (ATTR_ADDRESS1, aAddressl) ; 

allParmsAndAttrs. put (ATTR_CITY, aCity) ; 

allParmsAndAttrs .put (ATTR_COUNTRY_CODE, aCountryCode) ; 

allParmsAndAttrs .put (ATTR_PHONE, aPhone) ; 

allParmsAndAttrs .put (ATTR_CUSTOMER_PASSWORD, 
aCustomerPassword) ; 

allParmsAndAttrs .put (ATTR_AUTH_QUESTION, aAuthQuestion) ; 

allParmsAndAttrs. put (ATTR_AUTH_ANSWER, aAuthAnswer) ; 

allParmsAndAttrs .put (ATTR_LEGAL_CONTACT_FIRST_NAME, 
aLegalContactFirstName) ; 

allParmsAndAttrs .put (ATTRJ J EGAL_CONTACT_LAST_NAME, 
aLegalContactLastName) ; 
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allParmsAndAttrs .put (ATTR_STATE, aState) ; 
allParmsAndAttrs .put ( ATTR_POSTAL_CODE , aPostalCode) ; 

returnCode = conn . makeRequest (COMB0_CREATE_BUSINESS_ACCOUNT, 

allParmsAndAttrs) ; 

pool . checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

} 

catch (ResourceException re) { 

System. err . print In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return createBusinessAccount ( 
aCompanyName , 
aCompanyType , 
aAddressl, 
aCity, 

aCountryCode, 
aPhone , 

aCustomerPassword, 
aAuthQuestion, 
aAuthAnswer, 
aLegalContactFirstName , 
aLegalContactLastName , 
aState, 
aPostalCode, 
optionalAttributes , 
count + 1) / 

} 

) 

} 



/** 

* This method creates a technical contact and returns an 

* automatically generated technical contact id (NIC Handle) . 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
ATTR_TECH_CONTACT_ID 

* </PRExBR> 

* ©param aFirstName the attribute value 

* ©param aLastName the attribute value 

* ©param aOrganization the attribute value 

* ©param aAddressl the attribute value 

* ©param aCountryCode the attribute value 

* ©param aPhone the attribute value 

* ©param aEmail the attribute value 

* ©param aTechContactPassword the attribute value 

* ©param aCity the attribute value 

* ©return the Wholesale Server Protocol Server response 
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* ©exception nsi . wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

NSIWholesaleAPI#COMMAND CREATE 



NSIWholesaleAPI#ATTR_FIRST_NAME 
NS I Whol e sal e AP I # ATTR_LAST_NAME 
NSI Whol esaleAPI# ATTRJDRG AN I Z AT ION 
NSIWholesaleAPI#ATTR_ADDRESSl 
10 * ©see NSIWholesaleAPI#ATTR_COUNTRY_CODE 

NSI Who 1 e s a 1 e AP I # ATTR_PHONE 



15 



20 

WSPResponse#COMMAND_EXECUTI0N_SUCCEEDED_PR0PERTIES_BEING_RETURNED 

* ©see NSIWholesaleAPI#ATTR_TECH_CONTACT_ID 
★ 

25 */ 

public WSPResponse createTechnicalContact { 

String aFirstName, 

String aLastName, 

String aOrganization, 
30 String aAddressl, 

String aCountryCode f 

String aPhone, 

String aEmail, 

String aTechContactPassword, 
35 String aCity) 

throws NSIWholesaleException { 

return createTechnicalContact ( 
aFirstName, 
aLastName, 

40 aOrganization, 

aAddressl , 
aCountryCode, 
aPhone , 
aEmail , 

45 aTechContactPassword, 

aCity, 

new Properties () , 
0) ; 

} 

50 /** 

* This method creates a technical contact and returns an 

* automatically generated technical contact id (NIC Handle) 

* <BRxPRE> 

Optional Attribute Key(s) : 
55 ATTR FAX 
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Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
ATTR_TECH_CONTACT_I D 

* </PRExBR> 

* ©param aFirstName the attribute value 

* Oparam aLastName the attribute value 

* ©param aOrganization the attribute value 

* ©param aAddressl the attribute value 

* ©param aCountryCode the attribute value 

* ©param aPhone the attribute value 

* ©param aEmail the attribute value 

* ©param aTechContactPassword the attribute value 

* ©param aCity the attribute value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesal e AP I # COMMAND_CRE ATE 

* ©see NSI Wholesale API #CLASS_TECHNICAL_CONTACT 

* ©see NSIWholesaleAPI#COMBO_CREATEJTECHNICAL_CONTACT 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_F I RST_NAME 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_LAST___NAME 

* ©see NS I Who 1 e S a 1 eAP I # ATTR_ORGANI Z AT ION 

* ©see NS I Who 1 e s a 1 eAP I # ATTR__ADDRES S 1 

* ©see NSIWholesaleAPI#ATTR_COUNTRY_CODE 

* ©see NSIWholesaleAPI#ATTR__PHONE 

* ©see NS I Who 1 e s a 1 eAP I # ATTR__EMA I L 

* ©see NSIWholesaleAPI#ATTRJTECH_CONTACT_PASSWORD 

* ©see NSIWholesaleAPI#ATTR_CITY 
* 

* ©see NS I Who 1 e sa 1 eAP I # ATTR_STATE 

* ©see NSIWholesaleAPI#ATTR_POSTAL_CODE 

* ©see NSIWholesaleAPI#ATTR_FAX 

* ©see WSPResponse#INVALID_VALUE 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see NSIWholesaleAPI#ATTRJTECH_CONTACT_ID 
* 

*/ 

public WSPResponse createTechnicalContact ( 
String aFirstName, 
String aLastName, 
String aOrganization, 
String aAddressl, 
String aCountryCode, 
String aPhone, 
String aEmail, 

String aTechContactPassword, 
String aCity, 

Properties optionalAttributes) 
throws NSIWholesaleException { 

return createTechnicalContact { 

aFirstName, 

aLastName, 

aOrganization, 
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aAddressl, 
aCount ryCode , 
aPhone, 
aEmail, 

aTechContact Password, 
aCity, 

opt ionalAt tributes, 
0) ; 

} 

protected WSPResponse createTechnicalContact ( 
String aFirstName, 
String aLastName, 
String aOrganization, 
String aAddressl, 
String aCountryCode, 
String aPhone, 
String aEmail, 

String aTechContactPassword, 
String aCity, 

Properties optionalAttributes , 
int count) 
throws NSIWholesaleException { 

String methodName = className + " .createTechnicalContact (StringX9, 
Properties, int) " ; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool . checkout () ; 
Properties allParmsAndAttrs = new Properties 0 ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

allParmsAndAttrs .put (ATTR_FIRST_NAME, aFirstName) ; 
allParmsAndAttrs .put ( ATTR_LAST_NAME , aLastName) ; 
allParmsAndAttrs .put ( ATTR_ORGANI ZATION , aOrganization) ; 
allParmsAndAttrs. put (ATTR_ADDRESS1, aAddressl) ; 
allParmsAndAttrs . put ( ATTR_COUNTR Y_COD E , aCountryCode) ; 
allParmsAndAttrs . put (ATTR_PHONE, aPhone) ; 
allParmsAndAttrs. put (ATTR_EMAIL, aEmail) ; 
allParmsAndAttrs . put ( ATTR_TECH_CONTACT_PAS SWORD , 
aTechContactPassword) ; 

allParmsAndAttrs. put (ATTR_CITY, aCity) ; 

returnCode = 

conn.makeRequest (COMBO_CREATE_TECHNICAL_CONTACT, allParmsAndAttrs) ; 
pool . checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

} 
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catch (ResourceException re) { 

System. err. print In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return createTechnicalContact ( 
aFirstName, 
aLastName, 
aOrganization, 
aAddressl, 
aCountryCode, 
a Phone, 
a Email, 

aTechContactPassword , 
aCity, 

optionalAttributes , 
count + 1) ; 

} 

} . 

} 

/** 

* This method creates a technical contact and returns an 

* automatically generated technical contact id (NIC Handle) . 

* <BR><PRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
ATTR_TECH_CONTACT_I D 

* </PRExBR> 

* ©param aFirstName the attribute value 

* ©param aLastName the attribute value 

* ©param aOrganization the attribute value 

* ©param aAddressl the attribute value 

* ©param aCountryCode the attribute value 

* ©param aPhone the attribute value 

* ©param aEmail the attribute value 

* ©param aTechContactPassword the attribute value 

* ©param aCity the attribute value 

* ©param aState the attribute value 

* ©param aPostalCode the attribute value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . j avaapi .NSIWholesaleException when 
unable to complete command 

* ©see NS I Who 1 e s a 1 e AP I # COMMAND_CRE ATE 

* ©see NSIWholesaleAPI#CLASS_TECHNICAL_CONTACT 

* ©see NSIWholesaleAPI#COMBO_CREATE_TECHNICAL_CONTACT 

* ©see NSIWholesaleAPI#ATTR_FIRST_NAME 

* ©see NS I Who lesaleAPI # ATTR_L AS T_NAM E 

* ©see NSIWholesaleAPI#ATTR_ORGANIZATION 

* ©see NS I Who 1 e sa 1 e AP I # ATTR__ADDRE SS 1 

* ©see NSIWholesaleAPI#ATTR_COUNTRY_CODE 

* ©see NSIWholesaleAPI#ATTR_PHONE 

* ©see NSIWholesaleAPI#ATTR_EMAIL 

* ©see NSIWholesaleAPI#ATTRJTECH_CONTACT_PASSWORD 

* ©see NSIWholesaleAPI#ATTR_CITY 

* ©see NSIWholesaleAPI#ATTR STATE 
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* ©see NSIWholesaleAPI#ATTR_POSTAL_CODE 

* ©see NSIWholesaleAPI#ATTR_FAX 
* 

* ©see wSPResponse#INVALlD_VALUE 

* ©see 

WSPResponse^COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see NSIWholesaleAPI#ATTRJTECH_CONTACT_ID 
* 

*/ 

public WSPResponse createTechnicalContact ( 
String aFirstName, 
String aLastName, 
String aOrganization, 
String aAddressl, 
String aCountryCode, 
' String aPhone, 
String aEmail, 

String aTechContact Password, 
String aCity, 
String aState, 
String aPostalCode) 
throws NSIWholesaleException { 

return createTechnicalContact ( 

aFirstName, 

aLastName, 

aOrganization, 

aAddressl, 

aCountryCode, 

aPhone , 

aEmail , 

aTechContact Password, 

aCity, 

aState, 

aPostalCode, 

new Properties () , 

0); 

} 

I * * 

* This method creates a technical contact and returns an 

* automatically generated technical contact id (NIC Handle) . 

* <BR><PRE> 

Optional Attribute Key(s) : 
ATTR_FAX 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING - RETURNED 

Expected Result Property Key(s) Returned: 
ATTR_TECH_CONTACT_ID 

* </PRExBR> 

* ©param aFirstName the attribute value 

* ©param aLastName the attribute value 

* ©param aOrganization the attribute value 

* ©param aAddressl the attribute value 

* ©param aCountryCode the attribute value 

* ©param aPhone the attribute value 

* ©param aEmail the attribute value 
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* ©param aTechContactPassword the attribute value 

* ©param aCity the attribute value 

* ©param aState the attribute value 

* ©param aPostalCode the attribute value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 



NSIWholesaleAPI#ATTR LAST NAME 



NSIWholesaleAPI#ATTR_EMAIL 

NSIWholesaleAPI#ATTRJTECH_CONTACT_PASSWORD 
NSIWholesaleAPI#ATTR_CITY 
NSIWholesaleAPI # ATTR_STATE 
NSIWholesaleAPI#ATTR POSTAL CODE 





* 


©see 


10 


* 


©see 




* 


©see 




* 


©see 




★ 


©see 




★ 


©see 


15 


* 


©see 




* 


©see 




* 


©see 




* 


©see 




* 


©see 


-20 


* 


©see 




* 


©see 




* 


©see 




* 






* 


©see 


25 


* 






* 


©see 




* 


©see 



©see NSIWholesaleAPI#ATTR FAX 



WSPResponse#C0MMAND_EXECUTI0N_SUCCEEDED_PROPERTIES_BEING_RETURNED 
* ©see NSIWholesaleAPI#ATTR_TECH_CONTACT_ID 

30 

*/ 

public WSPResponse createTechnicalContact ( 
String aFirstName, 
String aLastName, 
35 String aOrganization, 

String aAddressl, 
String aCountryCode, 
String aPhone, 
String aEmail, 
40 String aTechContactPassword, 

String aCity, 
String aState, 
String aPostalCode, 
Properties optionalAttributes) 
45 throws NSIWholesaleException { 

return createTechnicalContact ( 
aFirstName, 
aLastName, 
aOrganization, 
50 aAddressl, 

aCountryCode, 
a Phone, 
aEmail, 

aTechContactPassword , 
55 aCity, 

aState, 
aPostalCode, 
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opt ionalAt tributes, 
0); 

} 

protected WSPResponse createTechnicalContact ( 
5 String aFirstName, 

String aLastName, 
String aOrganization, 
String aAddressl, 
String aCountryCode, 
1 0 String aPhone , 

String aEmail, 

String aTechContact Password, 
String aCity, 
String aState, 
15 String aPostalCode, 

Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + 
20 M .createTechnicalContact (StringXll, Properties, int) "; 

if (count > retry) { 

throw" new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

25 NSIWholesaleConnection conn = null; 

WS PRe sponse re turnCode ; 

try { 

conn = (NSIWholesaleConnection) pool. checkout () ; 
30 Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

35 allParmsAndAttrs .put (ATTR__FIRST_NAME, aFirstName) ; 

allParmsAndAttrs .put (ATTR_LAST__NAME, aLastName) ; 

allParmsAndAttrs .put ( ATTR_ORGANI ZATION , aOrganization) ; 

allParmsAndAttrs .put (ATTR_ADDRESS1 , aAddressl) ,- 

allParmsAndAttrs .put ( ATTR_COUNTRY_CODE , aCountryCode) ; 
40 allParmsAndAttrs .put (ATTR_PHONE, aPhone) ; 

allParmsAndAttrs. put (ATTR_EMAIL, aEmail) ; 

allParmsAndAttrs .put (ATTRJTECH_CONTACT_P AS SWORD, 
aTechContactPassword) ; 

allParmsAndAttrs. put (ATTR_CITY, aCity) ; 
45 allParmsAndAttrs. put (ATTR_STATE, aState) ; 

allParmsAndAttrs. put (ATTR_POSTAL_CODE, aPostalCode) ; 

returnCode = 

conn . makeRequest ( COMBO__CREATE_TECHNICAL_CONTACT , allParmsAndAttrs) ; 
50 P°°l • checkln (conn) ; 

return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

55 } 

catch (ResourceException re) { 
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System. err .print In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

5 return createTechnicalContact ( 

aFirstName, 
aLastName, 
aOrganization, 
aAddressl, 

1 0 aCoun t ry Code , 

a Phone, 
aEmail, 

aTechContactPassword, 
aCity, 

15 aState, 

aPostalCode, 
optionalAttributes , 
count + 1) ; 

} 

20 } 
} 



J * * 

25 * This method registers a new domain product for an existing 

* customer account. This request assumes that the domain 

* name will be hosted by some organization other than 

* Network Solutions. 

* <BR>NOTE: This command is asynchronous. Receipt of the 

30 * COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED code 

* indicates that the command has been successfully queued. 

* <BR><PRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
35 Expected Result Property Key(s) Returned: 

ATTR_ISP_PASSWORD 

* </PRE><BR> 

* ©param pCustomerAccountld the parameter value 

* @param pCustomerPassword the parameter value 
40 * Oparam aDomainName the attribute value 

* ©param aHostNamel the attribute value 

* ©param aHostAddrl the attribute value 

* ©param aHostName2 the attribute value 

* ©param aHostAddr2 the attribute value 

45 * ©param aTechContactld the attribute value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi . wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NS I Who 1 e s a 1 e AP I # COMMAND_CRE ATE 
50 * ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBO_CREATE_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 

* ©see NS I Who lesaleAPI # ATTR__DOMA IN_NAME 
55 * ©see NS I Who 1 e s a 1 e AP I # ATTR_H0S T_NAME 1 

* ©see NS I Whol e sal eAP I # ATTR_HOST_ADDR 1 

* ©see NSIWholesaleAPI#ATTR HOST_NAME2 
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* ©see NS I Whol e sa le AP I # ATTR_HOST_ADDR2 

* ©see NSIWholesaleAPItfATTR^TECH^CONTACT^ID 
★ 

* ©see WSPResponse#COMMAND_FAILED_UNKNOWN_ERROR 

* ©see WSPResponse#GENERAL~ACCESS__DENIED 

* ©see WSPResponse#INVALID~VALUE 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see NSIWholesaleAPIttATTR ISP PASSWORD 



10 



*/ 

public WSPResponse createDomain ( 

String pCustomerAccountld, 

String pCustomerPas sword, 
15 String aDomainName, 

String aHostNamel, 

String aHostAddrl, 

String aHostName2, 

String aHostAddr2, 
20 String aTechContactld 

) 

throws NSIWholesaleException { 
return createDomain ( 

pCus tomer Account Id , 
25 pCustomerPassword, 

aDomainName, 
aHostNamel , 
aHostAddrl, 
aHostName2, 

30 aHostAddr2, 

aTechContactld, 
new Properties () , 
0); 

} 

35 /** 

* This method registers a new domain product for an existing 

* customer account. This request assumes that the domain 

* name will be hosted by some organization other than 

* Network Solutions. 

40 * <BR>NOTE: This command is asynchronous. Receipt of the 

* COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED code 

* indicates that the command has been successfully queued. 

* <BRxPRE> 

Expected Major Result Code: 
45 COMMAND_EXECUTION__SUCCEEDED_PROPERTIES_BEING_RETURNED 

Expected Result Property Key(s) Returned: 
ATTR_I S P_PASSWORD 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 
50 * ©param pCustomerPassword the parameter value 

* ©param aDomainName the attribute value 

* ©param aHostNamel the attribute value 

* ©param aHostAddrl the attribute value 

* ©param aHostName2 the attribute value 
55 * ©param aHostAddr2 the attribute value 

* ©param aTechContactld the attribute value 

* ©param optionalAttributes a property list of optional attributes 
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* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSI wholesaleAPI #C0MMAND_ CREATE 

* ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBO_CREATE_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 

* ©see NSIWholesaleAPI#ATTR_DOMAIN_NAME 

* ©see NS I Whole sale API #ATTR_H0ST_NAME1 

* ©see NS I Who le s a 1 e AP I # ATTR_H0 ST_ADDR 1 

* ©see NS I Whole s a 1 eAP I #ATTR_HOST_NAME2 

* ©see NSIWholesaleAPI#ATTR_HOST_ADDR2 

* ©see NSIWholesaleAPI#ATTRJTECH_CONTACT_ID 
* 

* ©see WSPResponse#COMMAND_FAILED_UNKNOWN_ERROR 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#INVALID_VALUE 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see NSIWholesaleAPI#ATTR_ISP_PASSWORD 
* 

*/ 

public WSPResponse createDomain ( 
String pCustomerAccountld, 
String pCustomerPassword, 
String aDomainName, 
String aHostNamel, 
String aHostAddrl, 
String aHostName2, 
String aHostAddr2, 
String aTechContactld, 
Properties optionalAttributes) 
throws NSIWholesaleException { 
return createDomain ( 

pCustomerAccountld, 

pCustomerPassword, 

aDomainName, 

aHostNamel , 

aHostAddrl, 

aHostName2 , 

aHostAddr2, 

aTechContactld, 

optionalAttributes, 

0); 

} 

protected WSPResponse createDomain ( 
String pCustomerAccountld, 
String pCustomerPassword, 
String aDomainName, 
String aHostNamel, 
String aHostAddrl, 
String aHostName2, 
String aHostAddr2 , 
String aTechContactld, 
Properties optionalAttributes, 
int count) 
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throws NSiwholesaleException { 
int rc; 

String methodName = className + » . createDomain (StringX8 , 
Properties, int) " ; 

5 System. out .println ( "*** Made it into createDomain..."); 

if (count > retry) { 

rc = refundCard(pCustomerAccountId, aDomainName, 

CreateDomainPrice , CreateDomainWNRP , 
optionalAttributes) ; 

10 throw new NSiwholesaleException (methodName + "Unable to 

complete command"); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 
15 // Double check to see if the domain really is available (to 

minimize charges) 

// with immediate credits 
try { 

System. out .println ( " ***Attempting to verify domain is 

20 available."); 

WSPResponse wspResponse = verifyDomainName ( aDomainName) ; 
if ( wspResponse. getMa jorResultCode () == 

WSPResponse . COMMAND_EXECUTION_SUCCEEDED_NO_DATA__BEING_RETURNED) { 
25 // See if credit card information is available, if so get 



55 



transaction 
Validation. ») 



System. out .println ( "*** Begining to do Charge Card 



rc = ChargeCard (pCustomerAccountld, aDomainName, 
30 CreateDomainPrice, CreateDomainWNRP, 

optionalAttributes) ; 

if (rc != 0) { 

// Bad credit card. Return bad code, 
throw new NSiwholesaleException (methodName + "Credit card 

35 declined for:" + 

aDomainName) ; 

} 

} else { 

// Domain name not available. Return bad code. 
40 throw new NSiwholesaleException (methodName + "Domain name 

not available: "+ 

aDomainName) ; 

) 

} 

45 catch (NSiwholesaleException e) { 

throw new NSiwholesaleException ( "Domain name previously 
taken:" + aDomainName); 

} 

// All o.k. create the domain. 
50 System. out .println (" *** After the credit card interaction, 

going on to create a name . " ) ; 
try { 

conn = (NSIWholesaleConnection) pool . checkout ( ) ; 
Properties allParmsAndAttrs = new Properties () ; 



// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 
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allParmsAndAttrs .put (PARM_CUSTOMER_ACCOUNT_ID, 
pCustomerAccountld) ; 

allParmsAndAttrs .put ( PARM_CUSTOMER_PAS SWORD , 
5 pCustomer Pas sword) / 

allParmsAndAttrs .put ( ATTR_DOMAI N_NAME , aDomainName) ; 
allParmsAndAttrs .put ( ATTR_HOST_NAME 1 , aHostNamel) 
allParmsAndAttrs .put ( ATTR_H0ST_ADDR1 , aHostAddrl) 
allParmsAndAttrs .put (ATTR_HOST_NAME2 , aHostName2) 
10 allParmsAndAttrs. put (ATTR_HOST_ADDR2 , aHostAddr2) , 

allParmsAndAttrs .put (ATTRJTECH_CONTACT_ID, aTechContactld) ; 

returnCode = conn . makeRequest (COMBO_CREATE_DOMAIN, 

allParmsAndAttrs) ; 
15 pool . checkln (conn) ; 

return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

20 } 

catch (ResourceException re) { 

System. err .print In (methodName + "Caught 
ResourceException" + re) ; 

} 

25 finally { 

return createDomain ( 

pCustomerAccountld, 
pCustomer Password, 
aDomainName, 

30 aHostNamel, 

aHostAddrl, 
aHostName2 , 
aHostAddr2, 
aTechContactld, 

35 optionalAttributes, 

count + 1) ; 

} 

} 

} 

40 

/•kit 

* This method registers a new domain product for an existing 

* customer account. This request assumes that the domain 

* name will be hosted by some organization other than 
45 * Network Solutions . 

* <BR>NOTE: This command is asynchronous. Receipt of the 

* COMMAND_EXECUTION_SUCCEEDED_PROPERTIES__BEING_RETURNED code 

* indicates that the command has been successfully queued. 

* <BRxPRE> 

50 Expected Major Result Code: 

COMMAND_EXECUTION_SUCCEEDED_PROPERTIES__BEING_RETURNED 
Expected Result Property Key(s) Returned: 
ATTR_ISP_PASSWORD 

* </PRExBR> 

55 * ©param pCustomerAccountld the parameter value 

* ©param pCustomerPassword the parameter value 

* ©param aDomainName the attribute value 
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* ©param aHostldl the attribute value 

* ©param aHostId2 the attribute value 

* ©param aTechContactld the attribute value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale. toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSI Whole sale API #COMMAND_CREATE 

* ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBO_CREATE_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 

* ©see NSI Who lesaleAPI# ATTR_D0MA I N_NAM E 

* ©see NSIWholesaleAPI#ATTR_HOST_IDl 

* ©see NSIWholesaleAPI#ATTR_HOST_ID2 

* ©see NSIWholesaleAPI#ATTR_TECH_CONTACT_ID 
* 

* ©see WSPResponse#COMMAND_FAILED_UNKNOWN_ERROR 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#INVALID__VALUE 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see NSIWholesaleAPI#ATTR_ISP_PASSWORD 
* 

*/ 

public WSPResponse createDomain ( 
String pCustomerAccountld, 
String pCus tome rPas sword, 
String aDomainName, 
String aHostldl, 
String aHostId2 / 
String aTechContactld 
) 

throws NSIWholesaleException { 
return createDomain ( 

pCustomerAccountld, 
pCus t omer Pas sword , 
aDomainName, 
aHostldl, 
aHostId2, 
aTechContactld, 
new Properties () , 
0) ; 

} 

* 

* This method registers a new domain product for an existing 

* customer account. This request assumes that the domain 

* name will be hosted by some organization other than 

* Network Solutions. 

* <BR>NOTE: This command is asynchronous. Receipt of the 

* COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED code 

* indicates that the command has been successfully queued. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
ATTR_I S P_PASSWORD 

* </PRExBR> 
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* ©param pCustomerAccountld the parameter value 

* ©param pCustomerPassword the parameter value 

* ©param aDomainName the attribute value 

* ©param aHostldl the attribute value 
5 * ©param aHostId2 the attribute value 

* ©param aTechContactld the attribute value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi. wholesale, toolkit, javaapi . NSIWholesaleException when 
10 unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_CREATE 

* ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBO_CREATE_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 
15 * ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 

* ©see NSIWholesaleAPI#ATTRJDOMAIN_NAME 

* ©see NSIWhoiesaleAPI#ATTR_HOST_IDl 

* ©see NSIWholesaleAPI#ATTR_HOST_ID2 

* ©see NSIWholesaleAPI#ATTRJTECH_CONTACT_ID 

.-20 

* ©see WS PRe spon s e # COMMAND_FAI LED_UNKNOWN_ERROR 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#INVALID_VALUE 

* ©see 

25 WSPResponse#COMMAND_EXECUTI0N_SUCCEEDED_PR0PERTIES__BEING_RETURNED 

* ©see NSlWholesaleAPI#ATTR_ISP_PASSWORD 
* 

*/ 

public WSPResponse createDomain ( 
30 String pCustomerAccountld, 

String pCustomerPassword, 
String aDomainName, 
String aHostldl, 
String aHostld2, 
35 String aTechContactld, 

Properties optionalAttributes) 
throws NSIWholesaleException { 
return createDomain ( 

pCustomerAccountld, 
40 pCustomerPassword, 

aDomainName, 
aHostldl, 
aHostId2, 
aTechContactld , 
45 optionalAttributes, 

0); 

} 

protected WSPResponse createDomain ( 

String pCustomerAccountld, 
50 String pCustomerPassword, 

String aDomainName, 

String aHostldl, 

String aHostId2, 

String aTechContactld, 
55 Properties optionalAttributes, 

int count) 
throws NSIWholesaleException { 
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String methodName = className + " . createDomain (StringX6 , 
Properties, int) " ; 

if (count > retry) { 

throw new NSIWholesaleExcept ion (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool. checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

allParmsAndAttrs .put (PARM_CUSTOMER_ACCOUNT_ID, 
pCustomer Account Id) ; 

allParmsAndAttrs .put ( P ARM_CUS TOM ER_P AS SWORD, 
pCustomerPassword) ; 

allParmsAndAttrs .put (ATTR_DOMAIN_NAME, aDomainName) ; 

allParmsAndAttrs .put ( ATTR_HOS T_I D 1 , aHostldl) ; 

allParmsAndAttrs .put (ATTR_HOST_ID2 , aHostId2) ; 

allParmsAndAttrs .put (ATTR_TECH_CONTACT_ID, aTechContact Id) 

returnCode = conn.makeRequest (COMBO_CREATE_DOMAIN, 

allParmsAndAttrs) ; 

pool. checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

} 

catch (ResourceException re) { 

System. err. print In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return createDomain ( 

pCustomerAccountld, 
pCus tome r Pa s sword , 
aDomainName, 
aHostldl, 
aHostId2 , 
aTechContact Id, 
optionalAttributes , 
count + 1) ; 

} 

} 

} 

/** 

* This method registers a DNS Hosting product for an existing 

* customer account. 

* <BR>NOTE: This command is asynchronous. Receipt of the 

* COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING__RETURNED code 

* indicates that the command has been successfully queued. 
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* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION__SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
5 ATTR_DNS_HOSTING_CREATED 

ATTR_I S P_PASS WORD 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pCustomerPassword the parameter value 
10 * ©param aDomainName the attribute value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale. toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_CREATE 

15 * ©see NSIWholesaleAPI#CLASS_DNS_HOSTiNG 

* ©see NSIWholesaleAPI#C0MBO_CREATE_DNS_H0STING 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 

* ©see NS I who 1 e s a 1 e AP I # ATTR_DOMAI N_NAME 

20 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#INVALID_VALUE 

* ©see 

WSPResponse#C0M^4AND_EXECUTI0N_SUCCEEDED_PR0PERTIES_BEING_RETURNED 
25 * ©see NS I Who 1 e sa 1 e AP I # ATTR_DNS_HOS TING_CREATED 

* ©see NSIWholesaleAPI#ATTR_ISP_PASSWORD 
* 

*/ 

public WSPResponse createDnsHosting ( 
30 String pCustomerAccountld, 

String pCustomerPassword, 
String aDomainName) 
throws NSIWholesaleException { 
return createDnsHosting { 
35 pCustomerAccountld,, 

pCustomerPassword, 
aDomainName/ 
new Properties () , 
0) ; 

40 } 

/** 

* This method registers a DNS Hosting product for an existing 

* customer account . 

* <BR>NOTE: This command is asynchronous. Receipt of the 

45 * C0MMAND_EXECUTIONJSUCCEEDED_PROPERTIES_BEING_RETURNED code 

* indicates that the command has been successfully queued. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
50 Expected Result Property Key(s) Returned: 

ATTR_DNS_HOSTING_CREATED 
ATTR_ISP_PASSW0RD 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 
55 * ©param pCustomerPassword the parameter value 

* ©param aDomainName the attribute value 

* ©param optionalAttributes a property list of optional attributes 
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* ©return the Wholesale Server Protocol Server response 

* ©exception nsi . wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NS I Whole sale API #COMMAND_CREATE 

5 * ©see NSIWholesaleAPI#CLASSJDNS_HOSTING 

* ©see NSIWholesaleAPI#COMBO_CREATEJDNS_HOSTING 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_DOMAIN_NAME 

10 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#INVALID_VALUE 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
15 * ©see NSIWholesaleAPI#ATTR_DNS_HOSTING_CREATED 

* ©see NSIWholesaleAPI#ATTR_ISP_PASSWORD 
★ 

*/ 

public WSPResponse createDnsHosting ( 
20 String pCustomerAccountld, 

String pCustomerPassword, 
String aDomainName, 
Properties optionalAttributes) 
throws NSIWholesaleException { 
25 return createDnsHosting ( 

pCustomerAccountld, 
pCustomer Password , 
aDomainName, 
optionalAttributes, 
30 0) ; 

protected WSPResponse createDnsHosting ( 
String pCustomerAccountld, 
String pCustomerPassword, 
35 String aDomainName, 

Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + createDnsHosting (String, String, 
40 String, Properties, int) " ; 

if (count > retry) { 

rc = refundCard (pCustomerAccountld, aDomainName, 

CreateDnsHostPrice, CreateDnsHostWNRP, 
optionalAttributes) ; 

45 throw new NSIWholesaleException (methodName + "Unable to 

complete command") ; 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 
50 // Double check to see if the domain really is available (to 

minimize charges) 

// with immediate credits 
try { 

System. out .println ("***At tempting to verify domain for DNS 

•55 Hosting."); 

WSPResponse wspResponse = verif yDomainName ( aDomainName); 
if (wspResponse .getMajorResultCode ( ) == 
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WSPResponse . COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED) { 

// See if credit card information is available, if so get 



transaction 
Validation. 11 ) 



System. out .println (" *** Begining to do Charge Card 



rc = ChargeCard (pCustomerAccountld, aDomainName, 

CreateDomainPrice, CreateDomainWNRP, 
optionalAttributes) ; 

10 if (rc != 0) { 

// Bad credit card. Return bad code, 
throw new NSIWholesaleException (methodName + "Credit card 

declined for: " + 

aDomainName) ; 

15 } 

} else { 

// Domain name not available. Return bad code, 
throw new NSIWholesaleException (methodName + "Domain name 

not available: "+ 

20 aDomainName) ; 

} } 

catch (NSIWholesaleException e) { 

throw new NSIWholesaleException ( "Domain name previously 
25 taken:" + aDomainName); 

} 

try { 

conn = (NSIWholesaleConnection) pool . checkout ( ) ; 
30 Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

35 allParmsAndAttrs . put ( PARM_CUST0MER_ACCOUNT_ID , 

pCustomerAccountld) ; 

allParmsAndAttrs .put (PARM_CUS TOME R_P AS SWORD, 
pCustomerPassword) ; 

allParmsAndAttrs .put ( ATTR_DOMAIN_NAME , aDomainName) ; 

40 

returnCode = conn . makeRequest (COMBO_CREATE_DNS_HO STING, 

allParmsAndAttrs) ; 

pool . checkln (conn) ; 
return returnCode; 
45 } catch (Exception e) { 

try { 

pool . release (conn) ; 

catch (ResourceException re) { 
50 System. err .println (methodName + "Caught 

ResourceException" + re) ; 

} 

finally { 

return createDnsHosting ( 
55 pCustomerAccountld, 

pCustomerPassword, 
aDomainName, 
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optionalAttributes, 
count + 1) ; 



* This method allows a customer to modify one or more attributes 

* associated with a specific instance of a Domain product 
10 * registered to that customer. 

* This method will also convert a DNS Hosting product domain 

* into a standard domain. 

* <BR>NOTE : This command is asynchronous. Receipt of the 

* COMMAND_EXECUTION_SUCCEEDED_PROPERTIES - BEING_RETURNED code 
15 * indicates that the command has been successfully queued. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* </PRExBR> 

20 * ©param pCustomerAccountld the parameter value 

* ©param pCustomerPassword the parameter value 

* ©param pDomainName the parameter value 

* ©param aHostNamel the attribute value 

* ©param aHostAddrl the attribute value 
25 * ©param aHostName2 the attribute value 

* ©param aHostAddr2 the attribute value 

* ©param aTechContactld the attribute value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi . wholesale . toolkit . javaapi . NSIWholesaleException when 
30 unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 

* ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBO_MODlFY_DOMAlN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 
35 * ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 

* ©see NS I who 1 e s al e AP I # PARM_D0MA I N_NAME 

* ©see NSIWholesaleAPI#ATTR_HOST_NAMEl 

* ©see NSIWholesaleAPI#ATTR_HOST_ADDRl 

* ©see NSIWholesal e AP I # ATTR_HOS T_NAME 2 
40 * ©see NS I Whol e sa 1 e AP I # ATTR_H0ST_ADDR2 

* ©see NSIWholesaleAPI#ATTR_TECH_CONTACT_ID 
* 

* ©see WSPResponse#COMMAND_FAILED_UNKNOWN_ERROR 

* ©see WSPResponse#INVALID_VALUE 

45 * ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#OBJECT_NOT_FOUND 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
50 * ©see NSIWholesaleAPI#ATTR_TECH_CONTACT_ID 

* 

*/ 

public WSPResponse modif yDomain ( 
String pCustomerAccountld, 
55 String pCustomerPassword, 

String pDomainName, 
String aHostNamel, 
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String aHostAddrl , 
String aHostName2 / 
String aHostAddr2, 
String aTechContactld 
5 ) 

throws NSIWholesaleException { 
return modif yDomain ( 

pCus tomer Account Id , 
pCustomerPassword, 
10 pDomainName, 

aHostNamel, 
aHostAddrl, 
aHostName2 / 
aHostAddr2, 
15 aTechContactld, 

new Properties () , 
0) ; 

} 

/* * 

20 * This method allows a customer to modify one or more attributes 

* associated with a specific instance of a Domain product 

* registered to that customer. 

* This method will also convert a DNS Hosting product domain 

* into a standard domain. 

25 * <BR>NOTE: This command is asynchronous. Receipt of the 

* COMMAND_EXECUT I ON_SUCCEEDED_PRO PERT I E S_BE I NG_RETURNED code 

* indicates that the command has been successfully queued. 

* <BRxPRE> 

Expected Major Result Code: 
30 COMMAND_EXE CUT I ON_SUCCE ED ED_NO_DATA_B E I NG_RETURN E D 

* </PRExBR> 

* ©param pCus tomer Account Id the parameter value 

* ©param pCustomerPassword the parameter value 

* ©param pDomainName the parameter value 
35 * ©param aHostNamel the attribute value 

* ©param aHostAddrl the attribute value 

* ©param aHostName2 the attribute value 

* ©param aHostAddr2 the attribute value 

* ©param aTechContactld the attribute value 

40 * ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale, toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 
45 * ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBO_MODIFY_DOMAIN 

* ©see NSIWholesaleAPI#PARM__CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 

* ©see NSIWholesaleAPI# P ARM_ DOMA I N_NAME 
50 * ©see NSIWholesaleAPI#ATTR_HOST_NAMEl 

* ©see NSIWholesaleAPI#ATTR_HOST_ADDRl 

* ©see NSIWholesaleAPI#ATTR_HOST_NAME2 

* ©see NS I Who 1 e s a 1 e API # ATTR_HOST_ADDR2 

* ©see NSIWholesaleAPI#ATTR_TECH_CONTACT_ID 

55 

* ©see WSPResponse#COMMAND_FAILEDJJNKNOWN_ERROR 

* ©see WSPResponse#INVALID_VALUE 
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* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#OBJECT_NOT_FOUND 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED__NO_DATA_BEING_RETURNED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see NSIWholesaleAPI#ATTRJTECH_CONTACT_ID 
* 

*/ 

public WSPResponse modifyDomain( 
String pCustomerAccountld, 
String pCustomer Pas sword, 
String pDomainName, 
String aHostNamel, 
String aHostAddrl, 
String aHostName2, 
String aHostAddr2, 
String aTechContactld, 
Properties optionalAttributes) 
throws NSIWholesaleException { 
return modi fy Domain ( 

pCus t omerAccount Id , 

pCustomerPassword , 

pDomainName, 

aHostNamel, 

aHostAddrl, 

aHostName2 , 

aHostAddr2 , 

aTechContactld, 

optionalAttributes, 

0); 

} 

protected WSPResponse modifyDomain( 

String pCustomerAccountld, 

String pCustomerPassword, 

String pDomainName, 

String aHostNamel, 

String aHostAddrl, 

String aHostName2, 

String aHostAddr2, 

String aTechContactld, 

Properties optionalAttributes, 

int count) 
throws NSIWholesaleException { 

String methodName = className + 11 .modifyDomain (StringX8 , 
Properties, int) " ; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command") ; 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool. checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 
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propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

allParmsAndAttrs .put (PARM_CUSTOMER_ACCOUNT_ID, 
pCustomerAccountld) ; 

allParmsAndAttrs .put (PARM_CUSTOMER_P AS SWORD, 
pCustomerPassword) ; 

allParmsAndAttrs .put (PARMJD0MAIN_NAME, pDomainName) ; 

allParmsAndAttrs .put ( ATTR__H0ST_NAME 1 , aHostNamel) ; 

allParmsAndAttrs .put (ATTR_H0ST_ADDR1 , aHostAddrl) ; 

allParmsAndAttrs .put (ATTR_HOST_NAME2 , aHostName2) ; 

allParmsAndAttrs .put (ATTR_HOST_ADDR2 , aHostAddr2) ; 

allParmsAndAttrs .put <ATTR_TECH_CONTACT_ID, aTechContactld) 

returnCode = conn . makeRequest (COMBO_MODIFY_DOMAIN, 

allParmsAndAttrs) ; 

pool . checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

} 

catch (ResourceException re) { 

System. err . print In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return modif yDomain ( 

pCu s t omer Account I d , 
pCustomerPassword , 
pDomainName, 
aHostNamel , 
aHostAddrl , 
aHostName2 , 
aHostAddr2, 
aTe chCon t ac 1 1 d , 
optionalAttributes , 
count + 1) ; 



/* * 

* This method allows a customer to modify one or more attributes 

* associated with a specific instance of a Domain product 

* registered to that customer. 

* This method will also convert a DNS Hosting product domain 

* into a standard domain. 

* <BR>NOTE: This command is asynchronous. Receipt of the 

* COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED code 

* indicates that the command has been successfully queued. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pCustomerPassword the parameter value 
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* ©param pDomainName the parameter value 

* Oparam aHostldl the attribute value 

* ©param aHostId2 the attribute value 

* ©param aTechContactld the attribute value 

5 * ©return the Wholesale Server Protocol Server response 

* ©exception nsi . wholesale . toolkit . javaapi . NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 

* ©see NSIWholesaleAPI#CLASS_DOMAIN 

10 * ©see NSIWholesaleAPI#COMBO__MODIFY_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 

* ©see NS I Whol e sa leAP I # PARM_JDOMAI N_NAME 

* ©see NSIWholesaleAPI#ATTR_HOST_IDl 
15 * ©see NSIWholesaleAPl#ATTR_H0ST_ID2 

* ©see NSIWholesaleAPI#ATTR_TECH__CONTACT__ID 
* 

* ©see WS PRe spon s e #COMMAND_F AI LED_UNKNOWN_ERROR 

* ©see WSPResponse#INVALID_VALUE 

20 * ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#OBJECT_NOT_FOUND 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA__BEING_RETURNED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
25 * ©see NSIWholesaleAPI#ATTRJTECH_CONTACT_ID 

★ 

*/ 

public WSPResponse modifyDomain( • 
String pCustomerAccountld, 
30 String pCustomerPassword, 

String pDomainName, 
String aHostldl, 
. String aHostId2, 

String aTechContactld 
35 ) 

throws NSIWholesaleException { 
return modif yDomain ( 

pCustomerAccountld, 
pCustomer Pas sword , 
4 0 pDoma i nN ame , 

aHostldl , 
aHostId2, 
aTechCont act Id , 
new Properties!), 
45 0); 
} 

/** 

* This method allows a customer to modify one or more attributes 

* associated with a specific instance of a Domain product 
50 * registered to that customer. 

* This method will also convert a DNS Hosting product domain 

* into a standard domain. 

* <BR>NOTE: This command is asynchronous. Receipt of the 

* COMMAND_EXECUTION — SUCCEEDED_PROPERTIES_BEING_RETURNED code 
55 * indicates that the command has been successfully queued. 

* <BRxPRE> 
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Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 
5 * ©param pCustomerPassword the parameter value 

* ©param pDomainName the parameter value 

* ©param aHostldl the attribute value 

* ©param aHostId2 the attribute value 

* ©param aTechContactld the attribute value 

10 * ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleExcept ion when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 
15 * ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSlWholesaleAPI#COMBO_MODIFY_DOMAlN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 

* ©see NSIWholesal e A P I # P ARM_D0MA I N^NAME 
20 * ©see NSlwholesaleAPI#ATTR_HOST_IDl 

* ©see NSIWholesaleAPI#ATTR_H0ST_ID2 

* ©see NSIWholesaleAPI#ATTR_TECH_CONTACT_ID 

* ©see WSPResponse#COMMAND_FAILED_UNKNOWN_ERROR 
25 * ©see WS PRe spon s e # I NVAL I DEVALUE 

* ©see WSPReSponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#OBJECT_NOT_FOUND 

* ©see WSPResponse#C0MM7VND_EXECUTI0N_SUCCEEDED_N0_DATA_BEING_RETURNED 

* ©see 

30 WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see NSIWholesaleAPI#ATTRJTECH_CONTACT_ID 
* 

*/ 

public WSPResponse modif yDomain ( 
35 String pCustomerAccountld, 

String pCus tome rPas sword , 
String pDomainName, 
String aHostldl, 
String aHostId2, 
40 String aTechContactld, 

Properties optionalAttributes) 
throws NSIWholesaleException { 
return modi f yDomain ( 

p Cu s t ome rAccountld, 
45 pCustomerPassword, 

pDomainName , 
aHostldl, 
aHostId2, 
aTechContac t Id , 
50 optionalAttributes , 

0); 

} 

protected WSPResponse modif yDomain ( 
String pCustomerAccountld, 
55 String pCustomerPassword, 

String pDomainName, 
String aHostldl, 
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String aHostId2, 
String aTechContactld, 
Properties optionalAttributes , 
int count) 

5 throws NSIWholesaleException { 

String methodName = className + " .modifyDomain(StringX6 , 
Properties, int) " ; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
10 complete command"); 

} 

NSIWholesaleConnection conn - null; 
WS PRe spons e re turnCode ; 

15 try { 

conn = (NSIWholesaleConnection) pool . checkout ( ) ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 
20 propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

allParmsAndAttrs .put (PARM_CUSTOMER_ACCOUNT_ID, 
pCustomerAccountld) ; 

allParmsAndAttrs .put (PARM_CUS TOME R_PAS SWORD, 
25 pCustomerPassword) ; 

allParmsAndAttrs .put (PARM_DOMAIN_NAME, pDomainName) ; 
allParmsAndAttrs. put (ATTR_HOST_IDl, aHostldl) ; 
allParmsAndAttrs. put'(ATTR_HOST_ID2, aHostId2) ; 
allParmsAndAttrs. put (ATTR_TECH_CONTACT_ID, aTechContactld) ; 

30 

returnCode = conn.makeRequest (COMBO_MODIFY_DOMAIN, 

allParmsAndAttrs) ; 

pool .checkln (conn) ; 
return returnCode; 
35 } catch (Exception e) { 

try { 

pool . release (conn) ; 

catch (ResourceException re) { 
40 System. err .print In (methodName + "Caught 

ResourceException" + re) ; 

} 

finally { 

return modifyDomain( 
45 pCustomerAccountld, 

pCustomerPassword, 
pDomainName, 
aHostldl, 
aHostId2, 

50 aTechContactld, 

optionalAttributes , 
count + 1) ; 

} 

} 

55 } 
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* This method allows a technical contact of a customers domain 

* product to modify one or more attributes 

* associated with that specific instance of the Domain product 
5 * registered to that customer. 

* This method will also convert a DNS Hosting product domain 

* into a standard domain. 

* <BR>N0TE: This command is asynchronous. Receipt of the 

* COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED code 
10 * indicates that the command has been successfully queued. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* </PRExBR> 

15 * ©param pCustomerAc count Id the parameter value 

* ©param pTechContactld the parameter value 

* ©param pTechContactPassword the parameter value 

* ©param pDomainName the parameter value 

* ©param aHostNamel the attribute value 
20 * ©param aHostAddrl the attribute value 

* ©param aHostName2 the attribute value 

* ©param aHostAddr2 the attribute value 

* ©param aTechContactld the attribute value 

* ©param optionalAttributes a property list of optional attributes 
25 * ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale, toolkit . javaapi .NSIWholesaleExcept ion when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND^MODIFY 

* ©see NSIWholesaleAPI#CLASS_DOMAIN 

30 * ©see NSIWholesaleAPI#COMBO_MODIFY_DOMAIN 

* ©see NSIWholesaleAPI#PARM - CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_TECH_CONTACT_ID 

* ©see NSIWholesaleAPI#PARMJTECH_CONTACT_PASSWORD 

* ©see NS I Who 1 e S a 1 e AP I # P ARM_DOMAIN_NAME 
35 * ©see NS I Whol e s a leAP I # ATTR_HOST_NAME 1 

* ©see NSIWholesaleAPI#ATTR_HOST_ADDRl 

* ©see NS I Who 1 es a 1 e AP I # ATTR_H0ST_NAME2 

* ©see NS I Who 1 e s a le AP I # ATTR_HOST_ADDR2 

* ©see NSIWholesaleAPI#ATTR_TECH_CONTACT_ID 

40 

* ©see WSPResponse#COMMAND_FAILED_UNKNOWN_ERROR 

* ©see WSPResponse#INVALID_VALUE 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO__DATA_BEING_RETURNED 

45 * ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING__RETURNED 
* 

*/ 

public WSPResponse modif yDomain ( 
50 String pCus tome r Account Id, 

String pTechContactld, 

String pTechContactPassword, 

String pDomainName, 

String aHostNamel, 
55 String aHostAddrl, 

String aHostName2, 

String aHostAddr2, 
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String aTechContactld 

) 

throws NSIWholesaleExceptioh { 
return modif yDomain ( 

pCu s t ome r Ac c oun 1 1 d , 
pTechContact Id , 
pTechContactPassword , 
pDomainName , 
aHostNamel , 
aHostAddrl , 
aHostName2 , 
aHostAddr2, 
aTechContact Id , 
new Properties () , 
0) ; 

} 

/** 

* This method allows a technical contact of a customer's domain 

* product to modify one or more attributes 

* associated with that specific instance of the Domain product 

* registered to that customer. 

* This method will also convert a DNS Hosting product domain 

* into a standard domain. 

* <BR>NOTE: This command is asynchronous. Receipt of the 

* COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED code 

* indicates that the command has been successfully queued. 

* <BR><PRE> 

Expected Major Result Code': 
C0MMAND_EXECUTI0N_SUCCEEDED_NO_DATA_BEING_RETURNED 

* </PRExBR> 

* ©param pCus tome rAc count Id the parameter value 

* ©param pTechContactld the parameter value 

* ©param pTechContactPassword the parameter value 

* ©param pDomainName the parameter value 

* ©param aHostNamel the attribute value 

* ©param aHostAddrl the attribute value 

* ©param aHostName2 the attribute value 

* ©param aHostAddr2 the attribute value 

* ©param aTechContactld the attribute value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale, toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 

* ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBO_MODIFY__DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_TECH_CONTACT_ID 

* ©see NSIWholesaleAPI#PARMJTECH_CONTACT_PASSWORD 

* ©see NS I Who 1 e sale API # PARM_DOMAIN__NAME 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_HOST_NAME 1 

* ©see NS I Whol e sal e AP I # ATTR_H0ST_ADDR1 

* ©see NS I Who 1 e s a le AP I # ATTR__H0ST_NAME2 

* ©see NS I Whole sale API #ATTR_H0ST_ADDR2 

* ©see NSIWholesaleAPI#ATTRJTECH_CONTACT_ID 
* 

* ©see WSPResponse#COMMAND_FAILED_UNKNOWN_ERROR 
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* ©see WSPResponse#INVALID_VALUE 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#COMMAND__EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* ©see 

5 wSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
* 

*/ 

public WSPResponse modifyDomain ( 
String pCustomer Account Id, 
10 String pTechContactld, 

String pTechContactPassword, 
String pDomainName, 
String aHostNamel, 
String aHostAddrl, 
15 String aHostName2, 

String aHostAddr2, 
String aTechContactld, 
Properties optionalAt tributes) 
throws NSIWholesaleException { 
20 return modifyDomain ( 

pCustomerAccountld, 
pTechCont act Id , 
pTechContactPassword, 
pDomainName , 
25 aHostNamel, 

aHostAddrl, 
aHostName2, 
aHostAddr2 , 
aTechContactld, 
30 opt ionalAttributes , 

0) ; 

} 

protected WSPResponse modifyDomain ( 

String pCustomerAccountld, 
35 String pTechContactld, 

String pTechContactPassword, 

String pDomainName, 

String aHostNamel, 

String aHostAddrl, 
40 String aHostName2, 

String aHostAddr2, 

String aTechContactld, 

Properties optionalAttributes, 

int count) 

45 throws NSIWholesaleException { 

String methodName = className + " .modifyDomain (StringX 9, 
Properties, int) " ; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 

50 complete command"); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

55 try { 

conn = (NSIWholesaleConnection) pool . checkout ( ) ; 
Properties allParmsAndAttrs = new Properties 0 ; 
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// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

allParmsAndAttrs .put (PARM_CUSTOMER_ACCOUNT_ID, 
pCustomerAccountld) ; 

allParmsAndAttrs. put (PARM_TECH_CONTACT_ID, pTechContact Id) ,- 

allParmsAndAttrs .put (PARM_TECH_CONTACT_PAS SWORD, 
pTechContactPassword) ; 

allParmsAndAttrs. put ( PARM_DOMAIN_NAME , pDomainName) ; 

allParmsAndAttrs. put (ATTR_H0ST_NAME1, aHostNamel) ; 

allParmsAndAttrs .put (ATTR_H0ST_ADDR1, aHostAddrl) ; 

allParmsAndAttrs . put ( ATTR_HOST_NAME2 , aHostNarae2 ) ; 

allParmsAndAttrs . put ( ATTR_HOST_ADDR2 , aHostAddr2 ) ; 

allParmsAndAttrs .put ( ATTR_TECH_CONTACT_ID , aTechContactld) ; 

returnCode = conn.makeRequest (COMBO_MODIFY_DOMAIN, 

allParmsAndAttrs) ; 

pool .checkln( conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool. release (conn) ; 

} 

catch (ResourceException re) { 

System. err .print In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return modif yDomain ( 

pCustomerAccount Id , 
pTechContact Id , 
pTechContactPassword, 
pDomainName, 
aHostNamel, 
aHostAddrl, 
aHostName2 , 
aHostAddr2 , 
aTechContac t Id , 
optionalAttributes , 
count + 1) ; 

} 

} 

} 



/** 

* This method allows a technical contact of a customer's domain 

* product to modify one or more attributes 

* associated with that specific instance of the Domain product 

* registered to that customer. 

* This method will also convert a DNS Hosting product domain 

* into a standard domain. 

* <BR>NOTE: This command is asynchronous. Receipt of the 

* COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED code 

* indicates that the command has been successfully queued. 

* <BR><PRE> 
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Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pTechContactld the parameter value 

* ©param pTechContactPassword the parameter value 

* ©param pDomainName the parameter value 

* ©param aHostldl the attribute value 

* ©param aHostId2 the attribute value 

* ©param aTechContactld the attribute value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi . wholesale. toolkit . javaapi . NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#C0MMANDJ40DIFY 

* ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBO_MODIFY_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARMJTECH_CONTACT__ID 

* ©see NSIWholesaleAPI#PARMJTECH_CONTACT_PASSWORD 

* ©see NS I Who 1 e s a 1 e AP I # PARM_D0MA I N__NAME 

* ©see NSIWholesaleAPI#ATTR_HOST_IDl 

* ©see NSIWholesaleAPI#ATTR_H0ST_ID2 

* ©see NSIWholesaleAPI#ATTR_TECH__CONTACT__ID 
* 

* ©see WSPResponse#C0MMAND_FAILED_UNKN0WN_ERROR 

* ©see wsPResponse#INVALID_VALUE 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WS PRe spons e # C0MMAND_EXECUT ION_SUCCEEDED_NO_D ATA_BE I NG__RETURNED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES__BEING_RETURNED 
* 

*/ 

public WSPResponse modif yDomain ( 
String pCustomerAccountld, 
String pTechContactld, 
String pTechContactPassword, 
String pDomainName, 
- String aHostldl, 
String aHostld2, 
String aTechContactld 
) 

throws NSIWholesaleException { 
return modif yDomain ( 

pCustomerAccountld, 

pTechContactld, 

pTe chCon t ac t Pas sword , 

pDomainName, 

aHostldl, 

aHostId2, 

aTechContactld, 

new Properties 0 , 

0); 

} 

/** 

* This method allows a technical contact of a customer's domain 

* product to modify one or more attributes 

* associated with that specific instance of the Domain product 
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* registered to that customer. 

* This method will also convert a DNS Hosting product domain 

* into a standard domain. 

* <BR>N0TE: This command is asynchronous. Receipt of the 

5 * COMMAND_EXECUTION_SUCCEEDED_PROPERTlES_BEING_RETURNED code 

* indicates that the command has been successfully queued. 

* <BR><PRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_NOJDATA_BEINGJlETURNED 

10 * </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pTechContactld the parameter value 

* ©param pTechContactPassword the parameter value 

* ©param pDomainName the parameter value 
15 * ©param aHostldl the attribute value 

* ©param aHostId2 the attribute value 

* ©param aTechContactld the attribute value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

20 * ©exception nsi .wholesale. toolkit . javaapi .NSIWholesaleException when 

unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 

* ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBO_MODIFY_DOMAIN 

25 * ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_TECH_CONTACT_ID 

* ©see NSIWholesaleAPI#PARMJTECH_CONTACT_PASSWORD 

* ©see NSIWholesal e A P I # P ARM_DOMA I N_NAME 

* ©see NSIWholesaleAPl#ATTR_HOST_IDl 
30 * ©see NSIWholesaleAPI#ATTR_HOST_iD2 

* ©see NSIWholesaleAPI#ATTRJTECH_CONTACT_ID 
* 

* ©see WS PRe spons e# COMMAND_FAILED_UNKNOWN_ERROR 

* ©see WSPResponse#INVALID_VALUE 

35 * ©see WSPResponse#GENERAL__ACCESS_DENIED 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* ©see 

WSPResponse#COMMAND_EXECUTI0N_SUCCEEDED_PR0PERTIES_BEING_RETURNED 
* 

40 */ 

public WSPResponse modifyDomain ( 
String pCustomerAccountld, 
String pTechContactld, 
String pTechContactPassword, 
45 String pDomainName, 

String aHostldl, 
String aHostId2 f 
String aTechContactld, 
Properties optionalAttributes) 
50 throws NSIWholesaleException { 

return modifyDomain ( 

pCus tome rAc count I d , 
pTechContactld, 
pTechContactPassword , 
55 pDoma i nName , 

aHostldl, 
aHost!d2, 
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aTechContact Id , 
optionalAttributes , 
0) ; 

) 

5 protected WSPResponse modifyDomain ( 

String pCustomerAccountld, 
String pTechContactld, 
String pTechCont act Pas sword, 
String pDomainName, 
10 String aHostldl, 

String aHostld2, 
String aTechContact Id, 
Properties optionalAttributes, 
int count) 

15 throws NSIWholesaleException { 

String methodName = className + " .modifyDomain (StringX7 , 
Properties, int) "; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
20 complete command") ; 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

25 try { 

conn = (NSIWholesaleConnection) pool . checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 
30 propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

allParmsAndAttrs .put (PARM_CUSTOMER_ACCOUNT_ID, 
pCustomerAccountld) ; 

allParmsAndAttrs .put (PARM_JTECH_CONTACT_ID, pTechContactld) ; 
35 allParmsAndAttrs .put ( PARM_TECH_CONTACT_P AS SWORD, 

pTechContactPassword) ; 

allParmsAndAttrs .put (PARM_DOMAIN_NAME, pDomainName) ; 
allParmsAndAttrs .put (ATTR_H0ST_ID1 , aHostldl) ; 
allParmsAndAttrs .put (ATTR_H0ST_ID2, aHostId2) ; 
40 allParmsAndAttrs. put (ATTR_TECH_CONTACT_ID, aTechContactld) ; 

returnCode • conn.makeRequest (C0MB0__M0DIFY_D0MAIN, 

allParmsAndAttrs) ; 

pool . checkln ( conn) ; 
45 return returnCode; 

} catch (Exception e) { 
try { 

pool . release (conn) ; 

} 

50 catch (ResourceException re) { 

System. err .print In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

55 return modifyDomain( 

pCu s t ome r Ac c oun 1 1 d , 
pTechContactld, 
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pTechCont ac t Pa s sword , 

pDomainName, 

aHostldl, 

aHostId2, 

aTechContactld, 

optionalAttributes , 

count + 1) ; 

} 

} 

} 



/** 

* This method allows an Internet Service Provider (ISP) 

* to modify the Technical Contact Id of a specific domain product. 

* <BR>N0TE: This command is asynchronous. Receipt of the 

* COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING__RETURNED code 

* indicates that the command has been successfully queued. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_NO_DATA__BEING_RETXJRNED 

* </PRExBR> 

* ©param pCustomerAc count Id the parameter value 

* ©param plspPassword the parameter value 

* ©param pDomainName the parameter value 

* ©param aTechContactld the attribute value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 

* ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBO_MODIFY_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_ISP_PASSWORD 

* ©see NS I Who lesaleAPI# P ARM_DOMAI N_NAME 

* ©see NSIWholesaleAPI#ATTR_TECH_CONTACT_ID 
* 

* ©see WSPResponse#INVALID_VALUE 

* ©see WS PRe sponse#GENERAL__ACCESS_DENI ED 

* ©see WSPResponse#COMMAND_EXECUTION__SUCCEEDED_NO_DATA_BEING_RETURNED 
* 

*/ 

public WSPResponse modifyDomain ( 
String pCustomerAc count Id, 
String plspPassword, 
String pDomainName, 
String aTechContactld 
) 

throws NSIWholesaleException { 
return modifyDomain ( 

p Cu s t ome r Ac c oun 1 1 d , 

plspPassword, 

pDomainName, 

aTechContactld, 

new Properties () , 

0); 
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/** 

* This method allows an Internet Service Provider (ISP) 

* to modify the Technical Contact Id of a specific domain product. 

* <BR>NOTE: This command is asynchronous. Receipt of the 

* COMMAND_EXECUTION_SUCCEEDED_PROPERTIES - _BEING_RETURNED code 

* indicates that the command has been successfully queued. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED__NO_DATA_BEING_RETURNED 

* </PRExBR> 

* ©param pCustomer Account Id the parameter value 

* ©param plspPassword the parameter value 

* ©param pDomainName the parameter value 

* ©param aTechContactld the attribute value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 

* ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBO_MODIFY_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_ISP_PASSWORD 

* ©see NS I Who 1 e s al e AP I # PARM__DOMAIN_NAME 

* ©see NSIWholesaleAPI#ATTR_TECH_CONTACT_ID 
* 

* ©see WSPResponse#INVALID_VALUE 

* ©see WS PResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 
* 

*/ 

public WSPResponse modif yDomain ( 
String pCustomer Account Id, 
String plspPassword, 
String pDomainName, 
String aTechContactld, 
Properties optionalAttributes) 
throws NSIWholesaleException { 
return modif yDomain ( 

pCu s t ome r Ac coun 1 1 d , 

plspPassword, 

pDomainName, 

aTechContactld, 

optionalAttributes , 

0); 

} 

protected WSPResponse modif yDomain ( 
String pCustomerAccountld, 
String plspPassword, 
String pDomainName, 
String aTechContactld, 
Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + " .modif yDomain (StringX4 , 
Properties, int) 11 ; 

if (count > retry) { 
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throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn - null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool. checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

allParmsAndAttrs .put (PARM^CUSTOMER^ACCOUNT^ID, 
pCustomerAccountld) ; 

allParmsAndAttrs. put (PARM_ISP_PAS SWORD, plspPassword) ; 
allParmsAndAttrs . put ( PARM_DOMAIN_NAME , pDomainName) ; 
allParmsAndAttrs .put ( ATTR_TECH__CONTACT_ID , aTechContactld) ; 

returnCode = conn.makeRequest (COMBO_MODIFY_DOMAIN, 

allParmsAndAttrs) ; 

pool. checkln( conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release ( conn) ; 

catch (ResourceException re) { 

System. err .print In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return modify Domain ( 

pCustomerAccountld , 
plspPassword, 
pDomainName, 
aTechContactld, 
optionalAttributes , 
count + 1) ; 

} 

} 

} 



/* * 

* This method is used to modify one or more attributes 

* of an existing individual customer account. 

* <BRxPRE> 

Expected Major Result Code: 
C0MMAND_EXECUTION_SUCCEEDED_N0_DATA_BEING_RETURNED 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pCustomer Password the parameter value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 
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* ©see NSIWholesaleAPI#CLASS_INDIVIDUAL_ACCOUNT 

* ©see NSIWholesaleAPI#COMBO_MODIFY_INDIVIDUAL_ACCOUNT 

* ©see NSIWholesaleAPI#PARM_CUSTOMER__ACCOUNT_ID 

* ©see NSlWholesaleAPI#PARM_CUSTOMER_PASSWORD 
* 

* ©see NSIWholesaleAPI#ATTR_CUSTOMER_PASSWORD 

* ©see NSIWholesaleAPI#ATTR_FIRST_NAME 

* ©see NS I Who 1 e sa le AP I # ATTR_LAST_NAME 

* ©see NSIWholesaleAPI#ATTR_ADDRESSl 

* ©see NSIWholesaleAPl#ATTR_ADDRESS2 

* ©see NSIWholesaleAPI#ATTR_ADDRESS3 

* ©see NSIWholesaleAPI#ATTR_ADDRESS4 

* ©see NSIWholesaleAPI#ATTR_ADDRESS5 

* ©see NSIWholesaleAPI#ATTR_CITY 

* ©see NS I Who 1 e s a 1 e A P I # ATT R_S TATE 

* ©see NSIWholesaleAPI#ATTR_P0STAL_CODE 

* ©see NSIWholesaleAPI#ATTR_COUNTRY_CODE 

* ©see NSIWholesaleAPI#ATTR_PHONE 

* ©see NSIWholesaleAPI#ATTR_FAX 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_EMA I L 

* ©see NSIWholesaleAPI#ATTR_AUTH_QUESTION 

* ©see NSIWholesaleAPI#ATTR_AUTH_ANSWER 
* 

* ©see WSPResponse#GENERAL__ACCESS_DENIED 

* ©see WSPResponse#INVALID_VALUE 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 
* 

*/ 

public WSPResponse modi fy Individual Account ( 
String pCustomerAccountld, 
String pCustomer Pas sword) 
throws NSIWholesaleException { 

return modif ylndividualAccount ( 
pCu s t ome r Ac coun 1 1 d , 
pCustomer Pas sword , 
new Properties () , 
0); 

} 

/** 

* This method is used to modify one or more attributes 

* of an existing individual customer account. 

* <BRxPRE> 

Optional Attribute Key(s) : 

ATTR_CUSTOMER_PASSWORD 

ATTR_FIRST_NAME 

ATTR_LAST_NAME 

ATTR__ADDRESS1 

ATTR_ADDRESS2 

ATTR_ADDRESS3 

ATTR_ADDRESS4 

ATTR_ADDRESS5 

ATTR_CITY 

ATT RESTATE 

ATTR_POSTAL_CODE 

ATTR_COUNTRY_CODE 

ATTR_PHONE 

ATTR FAX 
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ATTR_EMAIL 
ATTR_AUTH_QUESTION 
ATTR AUTH ANSWER 



5 Expected Major Result Code: 

COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING — RETURNED 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pCustomerPassword the parameter value 

10 * ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi . wholesale . toolkit . javaapi .NSIWholesaleExcept ion when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 

15 * ©see NSIWholesaleAPI#CLASS_INDIVIDUAL_ACCOUNT 

* ©see NSIWholesaleAPI#COMBO_MODIFY_INDIVIDUAL_ACCOUNT 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 
* 

20 * ©see NS I Wholes ale API #ATTR__CUSTOMER — PASSWORD 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_F I RST — NAME 

* ©see NSIWholesaleAPI#ATTR_LAST_NAME 

* ©see NSIWholesaleAPI#ATTR_ADDRESSl 

* ©see NSIWholesaleAPI#ATTR_ADDRESS2 
25 * ©see NS I Whol e s a 1 e AP I # ATTR_ADDRES S 3 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_ADDRES S 4 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_ADDRES S 5 

* ©see NSIWholesaleAPI#ATTR_CITY 

* ©see NSI Who lesaleAPI # ATTR_ST ATE 

30 * ©see NSIWholesaleAPI#ATTR_POSTAL_CODE 

* ©see NSIWholesaleAPI#ATTR_COUNTRY_CODE 

* ©see NSlwholesaleAPI#ATTR_PHONE 

* ©see NSIWholesaleAPI#ATTR_FAX 

* ©see NSIWholesaleAPI#ATTR_EMAIL 

35 * ©see NSIWholesaleAPI#ATTR_AUTH_QUESTION 

* ©see NS I Whole sale API #ATTR_AUTH_ANSWER 
* 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#INVALID_VALUE 

40 * ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED__NO_DATA_BEING_RETURNED 

★ 

*/ 

public WSPResponse modif ylndividualAccount ( 
String pCustomerAccountld, 
45 String pCustomerPassword, 

Properties optionalAttributes) 
throws NSIWholesaleException { 

return modif ylndividualAccount ( 
pCustomerAccountld, 
50 pCustomerPassword, 

optionalAttributes , 
0); 

} 

protected WSPResponse modi fy Individual Account ( 
55 String pCustomerAccountld, 

String pCustomerPassword, 
Properties optionalAttributes, 
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int count) 
throws NSlWholesaleException { 

String methodName = className + " .modi fylndividualAccount (String, 
String, Properties , int) " ; 
5 if (count > retry) { 

throw new NSlWholesaleException (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn = null; 
10 WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool. checkout () ; 
Properties allParmsAndAttrs = new Properties {) ; 



15 



// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 



allParmsAndAttrs - put (PARM_CUST0MER_ACCOUNT_ID, 
20 pCustomerAccountld) ; 

allParmsAndAttrs .put ( PARM_CUSTOMER_P AS SWORD , 
pCustomerPassword) ; 

returnCode = 

25 conn.makeRequest (COMBO_MODIFY_INDIVIDUAL_ACCOUNT, allParmsAndAttrs) ; 

pool. checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

30 pool . release (conn) ; 

} 

catch (ResourceException re) { 

System. err .println (methodName + "Caught 
ResourceException" + re) ; 
35 } 

finally { 

return modifylndividualAccount ( 
pCustomerAccountld, 
pCustomerPassword, 
40 optionalAttributes, 

count + 1) ; 

} 

} 

} 

45 

* This method is used to modify one or more attributes 

* of an existing business (organization) customer account. 
50 * <BRxPRE> 

Expected Major Result Code: 
C0MMAND_EXECUTION_SUCCEEDED_N0_DATA_BEING_RETURNED 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 
55 * ©param pCustomerPassword the parameter value 

* ©return the Wholesale Server Protocol Server response 
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* ©exception nsi .wholesale . toolkit . javaapi - NSIWholesaleExcept ion when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 

* ©see NSIWholesaleAPI#CLASS_BUSINESS_ACCOUNT 

5 * ©see NSIWholesaleAPI#COMBOJ40DIFY_BUSINESS_ACCOUNT 

* ©see NSIWholesaleAPI#PARM__CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 
* 

* ©see NSIWholesaleAPI#ATTRj:USTOMER_PASSWORD 
10 * ©see NS I Who 1 e s a 1 e AP I # ATTR_COMPANY_NAME 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_C0M P ANY_JT YP E 

* ©see NSIWholesaleAPI#ATTR_ADDRESSl 

* ©see NS I Who 1 e s a le AP I # ATTR_ADDRES S 2 

* ©see NSIWholesaleAPI#ATTR_ADDRESS3 
15 * ©see NS IWholesal e AP I # ATTR_ADDRES S 4 

* ©see NSIWholesaleAPI#ATTR_ADDRESS5 

* ©see NSIWholesaleAPI#ATTR_CITY 

* ©see NS I Who 1 e sa 1 e AP I # ATTR_STATE 

* ©see NSIWholesaleAPI#ATTR_POSTAL_CODE 
20 * ©see NSIWholesaleAPI#ATTR_COUNTRY_CODE 

* ©see NSIWholesaleAPI#ATTR_PHONE 

* ©see NSIWholesaleAPI#ATTR_FAX 

* ©see NS I Who 1 e sa 1 e AP I # ATTR_EMAI L 

* ©see NSIWholesaleAPI#ATTR_AUTH_QUESTION 
25 * ©see NSIWholesaleAPI#ATTR_AUTH_ANSWER 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_LEGAL_CONTACT_F I RS T_NAME 

* ©see NS I Who 1 e sa 1 e AP I # ATTR_LEGAL_CONTACT_LAST_NAME 

* ©see NS I Who 1 e sa 1 e AP I #ATTR_LEGAL_CONTACT_ADDRESS 1 

* ©see NS I Whol e sa 1 eAP I #ATTR__LEGAL_CONTACT_ADDRE SS 2 
30 * ©see NS I who 1 e sa 1 eAP I # ATTR_LEGAL_CONTACT_ADDRE S S 3 

* ©see NSIWholesaleAPI#ATTR_LEGAL_CONTACT_ADDRESS4 

* ©see NS I Whol e sa le AP I # ATTR_LEGAL_CONTACT_ADDRES S 5 

* ©see NS I Whol e sal eAP I # ATTR__LEGAL_CONTACT_C I T Y 

* ©see NS I Whol e sa leAP I # ATTR_LEGAL_CONTACT_STATE 

35 * ©see NS I Whol e sa 1 eAP I # ATTR_LEGAL_CONTACT_POSTAL_CODE 

* ©see NS I Whol e sa 1 e API # ATTR_LEGAL_CONTACT__COUNTRY_CODE 

* ©see NS I Whol e sal eAP I # ATTR_LEGAL_C0NTACT_PH0NE 

* ©see NS I Who 1 e s a 1 eAP I # attr_legal_CONTACT_FAX 

* ©see NS I Whol e sal eAP I # ATTR_LEGAL_CONTACT_FAX 
40 * 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#INVALID_VALUE 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 
* 

45 */ 

public WSPResponse modifyBusinessAccount ( 
String pCustomerAccountld, 
String pCustomerPassword) 
throws NSIWholesaleException { 
50 return modifyBusinessAccount ( 

pCustomerAccountld, 
pCus tomerPas sword , 
new Properties () , 
0) ; 

55 } 

/** 

* This method is used to modify one or more attributes 
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* of an existing business (organization) customer account . 

* <BR><PRE> 

Optional Attribute Key(s) : 

ATTR_CUSTOMER_PASSWORD 
5 ATTR_COMPANY_NAME 

ATTR_COMPANY_TYPE 
ATTR_ADDRESS1 
ATTR_ADDRESS2 
ATTR_ADDRESS3 

10 ATTR_ADDRESS4 

ATTR_ADDRESS5 

ATTR — CITY 

ATTR_STATE 

ATTR_POSTAL_CODE 
1 5 ATTR_COUNTRY_CODE 

ATTR_PHONE 

ATTR_FAX 

ATTR_EMAIL 

ATT R_AUTH_QUE S T I ON 
20 ATTR_AUTH_ANSWER 

ATTR_LEGAL_CONTACT_FI RST JSTAME 

ATTR_LEGAL_CONTACT_LAST_NAME 

ATTR_LEGAL_CONTACT_ADDRE SSI 

ATTR_LEGAL_CONTACT_ADDRE S S 2 
25 ATTR_LEGAL_CONTACT_ADDRE S S 3 

ATTR_LEGAL_CONTACT__ADDRESS4 

ATTR~LEGAL~CONTACT_ADDRESS5 

ATTR_LEGAL_CONTACT_C I T Y 

ATTR_LEGAL_CONTACT_STATE 
30 ATTRJjEGAL_CONTACT_POSTAL_CODE 

ATTR_LEGAL_CONTACT_COUNTRY_CODE 

ATTR_LEGAL_CONTACT_PHONE 

ATTR_LEGAL_CONTACT_FAX 

ATTR_LEGAL_CONTACT_EMAI L 

35 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 
40 * ©param pCustomer Pas sword the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleExcept ion when 
unable to complete command 

45 

NSIWholesaleAPI#CLASS_BUSINESS_ACCOUNT 
NSIWholesaleAPI#COMBOJ40DIFY_BUSINESS_ACCOUNT 
NSIWholesaleAPI#PARM CUSTOMER ACCOUNT ID 



50 



55 



* 


©see 


* 


©see 


* 


©see 


* 


©see 


* 


©see 


* 






©see 


* 


©see 


* 


©see 


* 


©see 


* 


©see 


* 


©see 


* 


©see 



NAME 
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10 



NS I Who 1 e s a 1 e AP I # ATTR__LEGAL_CONTACT__LAST_NAME 
NS I Who lesaleAPI # ATTR_JLEG AL_CONTACT_ADD RE S S 1 
NSIWholesaleAPI#ATTR_LEGAL_CONTACT_ADDRESS2 
15 * ©Bee NSIWholesaleAPI#ATTR LEGAL CONTACT ADDRESS3 



* 


©see 


* 


©see 




©see 


* 


©see 


* 


©see 




©see 


* 


©see 


* 


©see 


* 


©see 


* 


©see 


* 


©see 


* 


©see 




©see 


* 


©see 


* 


©see 


* 


©see 


* 


©see 




©see 


* 


©see 


* 


©see 


* 


©see 


* 


©see 


* 


©see 


★ 


©see 


* 




* 


©see 


* 


©see 


* 


©see 


★ 




*/ 





NSIWholesaleAPI#ATTR_PHONE 
NS I Who lesaleAPI #ATTR_FAX 
NSIWholesaleAPI#ATTR EMAIL 



20 



25 



CODE 



30 

public WSPResponse modif yBusinessAccount ( 
String pCus tomerAccount Id, 
String pCustomer Pas sword, 
Properties opt ionalAt tributes) 
35 throws NSIWholesaleException { 

return modif yBusinessAccount { 
pCus tomerAccount Id , 
pCus tomer Pas sword , 
optionalAttributes , 
40 0); 
} 

protected WSPResponse modif yBusinessAccount ( 
String pCus tomerAccount Id, 
String pCustomerPas sword, 
45 Properties optionalAttributes, 

int count) 
throws NSIWholesaleException { 

String methodName = className + " .modif yBusinessAccount (String, 
String, Properties, int) " ; 
50 if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn = null; 
55 WSPResponse returnCode; 



try { 
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conn ■ (NSIWholesaleConnection) pool . checkout ( ) ; 
Properties allParmsAndAttrs = new Properties {) ; 

// put optional attributes 
5 propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

allParmsAndAttrs .put (PARM_CUSTOMER_ACCOUNT_ID, 
pCustomerAccountld) ; 

allParmsAndAttrs .put ( PARM_CUSTOMER_PAS SWORD, 
10 pCustomer Pas sword) ; 

returnCode = conn, make Request (COMBOJ^ODIFY_BUSINESS_ACCOUNT, 

allParmsAndAttrs) ; 

pool . checkln (conn) ; 
15 return returnCode; 

} catch (Exception e) { 
try { 

pool. release (conn) ; 

} 

20 catch (ResourceException re) { 

System, err .print In (methodName + "Caught 
ResourceException" + re) / 
} 

finally { 

25 return modif yBusinessAccount ( 

pCustomer Account Id , 
pCustomerPassword , 
optionalAttributes , 
count + 1) ; 

30 } 

} 

} 

/** 

35 * This method is used to modify one or more attributes 

* of an existing technical contact. 

* <BR><PRE> 

Expected Major Result Code: 
COMMAND_EXE CUT I ON_SUCC EEDED_NO_DATA__B E I NG^RETURNED 
40 * </PRExBR> 

* ©param pTechContactld the parameter value 

* ©param pTechContactPassword the parameter value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
45 unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 

* ©see NSIWholesaleAPI#CLASS_TECHNICAL_CONTACT 

* ©see NSIWholesaleAPI#COMBO_MODIFY_TECHNICAL_CONTACT 

* ©see NSIWholesaleAPI#PARM_TECH_CONTACT_ID 

50 * ©see NSIWholesaleAPIttPARMJTECH_CONTACT_PASSWORD 

* 

* ©see NSIWholesaleAPI#ATTR_FIRST_NAME 

* ©see NS I Who 1 e s a leAP I # ATTR_LAST__NAME 

* ©see NS I Who 1 e sa 1 eAP I # ATTR__ORGAN I ZATI ON 
55 * ©see NS I Who 1 e sa 1 eAP I # ATTR_ADDRESS 1 

* ©see NSIWholesaleAPI#ATTR_CITY 

* ©see NSIWholesaleAPI#ATTR STATE 
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©see 


NS I Who lesaleAPI #ATTR_POSTAL_CODE 


★ 


©see 


NSIWholesaleAPI#ATTR_COUNTRY_CODE 


★ 


©see 


NS I Whol e sa 1 e AP I #ATTR_PHONE 


* 


©see 


NSIWholesaleAPI#ATTR_FAX 


* 


©see 


NSIWholesaleAPI#ATTR_EMAIL 


* 


©see 


WSPResponse#GENERAL_ACCESS_DENIED 


★ 


©see 


WSPResponse#INVALID_VALUE 


* 
* 

*/ 


©see 


WSPResponse#COMMAND_EXECUTION_SUCCEEDED__NO_DATA_BEING_RETURNED 



public WSPResponse modi fyTechnical Contact ( 
String pTechContactld, 
String pTechContactPassword) 

throws NSIWholesaleException { 

return modif yTechnicalContact ( 



pTechContactld, 
pTechContactPassword, 
. new Properties () , 
0) ; 

} 

I ** 

* This method is used to modify one or more attributes 

* of an existing technical contact. 

* <BRxPRE> 

Optional Attribute Key(s) : 
ATTR_FIRST_NAME 
ATTR_LAS T_N AME 
ATTR_ORGANI ZAT ION 
ATTR_ADDRESS 1 
ATTR_CITY 
ATTR_STATE 
ATTR_POSTAL_CODE 
ATTR_COUNTRY_CODE 
ATTR_EMAIL 
ATTR_FAX 
ATTR__PHONE 

Expected Major Result Code: 
C0MMAND_EXECUTION_SUCCEEDED_N0_DATA_BEING_RETURNED 

* </PRExBR> 

* ©param pTechContactld the parameter value 

* ©param pTechContactPassword the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi . wholesale . toolkit . javaapi . NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 

* ©see NSIWholesaleAPI#CLASS_TECHNICAL_CONTACT 

* ©see NSIWholesaleAPI#COMBO_MODIFY_TECHNICAL_CONTACT 

* ©see NSIWholesaleAPI#PARM_TECH_CONTACT_ID 

* ©see NSIWholesaleAPI#PARM_TECH_CONTACT_PASSWORD 
* 

* ©see NSIWholesaleAPI#ATTR_FIRST_NAME 

* ©see NS I Who 1 e sa leAP I # ATTR_LAST_NAME 

* ©see NSIWholesaleAPI#ATTR_ORGANIZATION 

* ©see NSIWholesaleAPI#ATTR ADDRESS1 
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*. ©see NSIWholesaleAPI#ATTR_CITY 

* ©see NSIWholesaleAPI#ATTR_STATE 

* ©see NSIWholesaleAPI#ATTR_POSTAL_CODE 

* ©see NSIWholesaleAPI#ATTR_COUNTRY_CODE 

* ©see NSIWholesaleAPI#ATTR_PHONE 

* ©see NSIWholesaleAPI#ATTR_FAX 

* ©see NS I Whol e sal e AP I # ATTR_EMAI L 
* 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#INVALID_VALUE 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 
* 

*/ 

public WSPResponse modif yTechnicalContact ( 
String pTechContactld, 
String pTechContactPassword, 
Properties optionalAttributes) 
throws NSIWholesaleException { 

return modif yTechnicalContact ( 

pTechContactld, 

pTechContactPassword, 

optionalAttributes , 

0) ; 

} 

protected WSPResponse modif yTechnicalContact ( 
String pTechContactld, 
String pTechContactPassword, 
Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + " .modif yTechnicalContact (String, 
String, Properties, int) "; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command" ) ; 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool . checkout 0 ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) / 

allParmsAndAttrs. put (PARM_TECH_CONTACT_ID, pTechContactld) ; 
allParmsAndAttrs .put (P ARM JTECH_CONTACT_PAS SWORD, 
pTechContactPassword) / 

returnCode = 

conn.makeRequest ( C0MB0_M0DI FY_TECHNI CAL__CONTACT , allParmsAndAttrs) / 
pool . checkln ( conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 
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} 

catch (ResourceException re) { 

System. err .print In (methodName + "Caught 
ResourceException" + re); 

5 } 

finally { 

return modif yTechnicalContact ( 
pTechContactld, 
pTechContactPassword, 
10 optionalAttributes, 

count + 1) ; 

} 

} 

} 

15 

* This method is used to modify/reset a customer's account password. 

* <BRxPRE> 

20 Expected Major Result Code: 

COMMAND_EXECUT ION_SUCCEEDED_NO_DATA_BE ING_RETURNED 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param aCustomerPassword the attribute value 

25 * ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi . NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 

* ©see NSIWholesaleAPI#CLASS_PASSWORD 

30 * ©see NSI Whole saleAPI#C0MBO_MODIFY_PASSWORD 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#ATTR_CUSTOMER_PASSWORD 
* 

* ©see WSPResponse#GENERAL__ACCESS_DENIED 

35 * ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* 

*/ 

public WSPResponse modi fyPas sword ( 
String pCustomerAccountld, 
40 String aCustomerPassword) 

throws NSIWholesaleException { 
return modifyPassword( 

pCustomer Account Id , 
aCustomerPassword , 
45 new Properties () , 

0) ; 

} 

/** 

* This method is used to modify/reset a customer's account password. 
50 * <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 
55 * ©param aCustomerPassword the attribute value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 
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* ©exception nsi .wholesale. toolkit .javaapi .NSIWholesaleExcept ion when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 

* ©see NSIWholesaleAPI#CLASS_PASSWORD 

* ©see NSIWholesaleAPI#COMBO_MODIFY_PASSWORD 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#ATTR_CUSTOMER_PASSWORD 
* 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#COMMAND__EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 
* 

*/ 

public WSPResponse modi fy Pass word ( 
String pCustomer Account Id, 
String aCustomerPassword, 
Properties optionalAttributes) 
throws NSIWholesaleException { 
return modi fy Pas sword ( 

pCustomerAccountld, 

aCustomerPassword, 

optionalAttributes, 

0); 

} 

protected WSPResponse modi fy Pas sword ( 
String pCustomerAccountld, 
String aCustomerPassword, 
Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + " .modify Pas sword (String, String, 
Properties, int) " ; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command") ; 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool . checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

allParmsAndAttrs .put (PARM_CUSTOMER_ACCOUNT__ID, 
pCustomerAccountld) ,- 

allParmsAndAttrs .put (ATTR_CUSTOMER_PAS SWORD, 
aCustomerPassword) ; 

returnCode = c onn. make Reques t (COMB0_M0D IF Y_PASS WORD, 

allParmsAndAttrs) ; 

pool . checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool .release (conn) ; 
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} 

catch (ResourceException re) { 

System. err. print In (methodName + "Caught 
ResourceException" + re) ; 

5 } 

finally { 

return modifyPassword ( 

pCu s t ome r Ac c oun 1 1 d , 
aCustomerPassword , 
10 optionalAttributes , 

count + 1) ; 

} 



15 



} 



* This method is used to generate a list of available 

* domain names based on a specified list of keywords. 

* <BRxPRE> 

20 Expected Major Result Code: 

C0MMAND_EXECUTION_SUCCEEDED_PR0PERTIES_BEINGJ*ETURNED 
Expected Result Property Key(s) Returned: 
DomainNameO : 
DomainNamel : 

25 DomainName2 : 

DomainName3 : 
. . .etc. . . 

* </PRExBR> 

* ©param pKeyWords the parameter value 

30 * ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi . NSIWholesaleException when 
unable to complete command 

* ©see NS I Who 1 e s a 1 e AP I #COMMAND_GENERATE 

* ©see NSIWholesaleAPI#CLASS_DOMAIN_NAME 

35 * ©see NS I Who 1 e s a 1 eAP I #COMB0_GENERATE_D0MAI N__NAME 

* ©see NSIWholesaleAPI#PARMJCEY_WORDS 
* 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* ©see 

40 WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
* 

*/ 

public WSPResponse generateDomainName ( 
String pKeyWords) 
45 throws NSIWholesaleException { 

return generateDomainName ( 
pKeyWords , 
new Properties {) , 
0) ; 

50 } 

/** 

* This method is used to generate a list of available 

* domain names based on a specified list of keywords. 

* <BR><PRE> 

55 Expected Major Result Code: 

COMMAND_EXECUTI0N_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
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DomainNameO : 
DomainNamel : 
DomainName2 : 
DomainName3 : 
. . .etc. . . 

* </PRExBR> 

* ©param pKeyWords the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleExcept ion when 
unable to complete command 

* ©see NS I Who 1 e s a 1 e AP I # COMMAND__GENE RATE 

* ©see NSIWholesaleAPI#CLASS_DOMAIN_NAME 

* ©see NSI Who 1 e s a 1 e AP I # COMBO_GENERATE_DOMAI N_NAM E 

* ©see NSIWholesaleAPI#PARMJCEY_WORDS 
* 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
*/ 

public WSPResponse generateDomainName ( 
String pKeyWords, 
Properties optionalAttributes) 
throws NSIWholesaleException { 

return generateDomainName ( 
pKeyWords , 
optionalAttributes , 
0); 

} 

protected WSPResponse generateDomainName { 
String pKeyWords, 
Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + " .generateDomainName (String, 
Properties, int) " ; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command" ) ; 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool . checkout ( ) ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 
allParmsAndAttrs .put ( PARM_KEY_WORDS , pKeyWords) ; 
returnCode = conn . makeReques t ( COMBO_GENERATE_DOMAIN_NAME , 

allParmsAndAttrs) ; 

pool .checkln (conn) ; 
return returnCode; 
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} catch (Exception e) { 
try { 

pool .release (conn) ; 

} 

5 catch (ResourceException re) { 

System. err .println (methodName + "Caught 
ResourceException" + re) ; 

} 

finally ( 

10 return generateDomainName ( 

pKeyWords , 
optionalAttributes , 
count + 1 ) ; 

} 

15 } 

} 



/** 

20 * Retrieves a list of all domain products owned by customer. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
25 DomainNamel : 

DomainName2 : 
DomainName3 : 
. . . etc ... 

* </PRExBR> 

30 * ©param pCustomerAccountld the parameter value 

* ©param pCustomerPassword the parameter value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale. toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

35 * ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBO_LOOKUP__DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 

40 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* ©see 

WSPResponse#COMMAND_EXECUTION__SUCCEEDED_PROPERTIES__BEING_RETURNED 

45 

*/ 

public WSPResponse lookupDomain ( 
String pCustomerAccountld, 
String pCustomerPassword) 
50 throws NSIWholesaleException { 

return lookupDomain ( 

pCustomerAccountld, 
pCustomerPassword, 
new Properties () , 
55 0); 
} 
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* Retrieves a list of all domain products owned by customer. 

* <BR><PRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key{s) Returned: 

DomainNamel : 

DomainName2 : 

DomainName3 : 

. . .etc . . . 

* </PRExBR> 

* ©param pCus tome r Account Id the parameter value 
* * ©param pCustomer Pas sword the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi . wholesale . toolkit . javaapi .NSIWholesaleExcept ion when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBO_LOOKUPJDOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 
* 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see W S PRe spon s e # COMMAND_EXE CUT I ON_SUCCE EDE D__NO_DATA_BE I NG_RETURNED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
* 

*/ 

public WSPResponse lookupDomain{ 
String pCustomer Account Id, 
String pCustomerPassword, 
Properties optionalAttributes) 
throws NSIWholesaleException { 
return lookupDomain ( 

pCustomerAccountld, 

pCustomerPassword , 

optionalAttributes , 

0); 

} 

protected WSPResponse lookupDomain ( 
String pCustomerAccountld, 
String pCustomerPassword, 
Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + ". lookupDomain (String, String, 
Properties, int) " ; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn = null; 
WS PRe spons e re t urnCode ; 

try { 

conn = (NSIWholesaleConnection) pool . checkout ( ) ; 
Properties allParmsAndAttrs = new Properties () ; 
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// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAt tributes) ; 

5 allParmsAndAttrs .put (PARM_CUSTOMER_ACCOUNT_ID, 

pCustomerAccountld) ; 

allParmsAndAttrs .put (PARM_CUSTOMER_PAS SWORD, 
pCustomerPassword) ; 

10 returnCode = conn .makeRequest (COMBO_LOOKUP_DOMAIN, 

allParmsAndAttrs) ; 

pool. checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
15 try { 

pool . release (conn) ; 

} 

catch (ResourceException re) { 

System. err. print In (methodName + "Caught 
20 ResourceException" + re) ; 

} 

finally { 

return lookupDomain ( 

pCus tomerAccount Id , 
25 pCustomerPassword, 

optionalAttributes , 
count + 1) ; 

} 

} 

30 } 

* Retrieves detail information about a specific domain product 
35 * registered to a customer. This form of the lookup domain 

* command will also retrieve the status of the domain while 

* it is being processed or after it has failed. 

* <BRxPRE> 

Expected Major Result Code: 
40 COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

Expected Result Property Key(s) Returned: 

ATTR_DOMAIN_NAME 

ATTR_TECH_CONTACT_I D 

ATTR_H0STJJAME1 
45 ATTR_H0ST_ADDR1 

ATTR_H0ST_ID1 

ATTR_HOST_NAME2 

ATTR_HOST_ADDR2 

ATTR_HOST_ID2 
50 * </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pCustomerPassword the parameter value 

* ©param pDomainName the parameter value 

* ©return the Wholesale Server Protocol Server response 

55 * ©exception nsi .wholesale . toolkit . j avaapi .NSIWholesaleExcept ion when 

unable to complete command 

* ©see NSIWholesaleAPI#COMMAND LOOKUP 
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* ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBO_LOOKUP_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 
5 * ©see NS I Who 1 e s a 1 e AP I # P ARM_DOMAI N__NAME 

* 

* ©see WS PRe sponse#GENERAL_ACCESS_ DENI ED 

* ©see WSPResponse#OBJECTJUOT_FOUND 

* ©see 

10 WSPResponse#COMMAND__EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_TEXT_BEING_RETURNED 

*/ 

public WSPResponse lookupDomain ( 
15 String pCustomerAccountld, 

String pCustomerPassword, 
String pDbmainName) 
throws NSIWholesaleException { 
return lookupDomain ( 
20 pCustomerAccountld, 

pCustomerPassword, 
pDomainName, 
new Properties () , 
0); 

25 } 

f* * 

* Retrieves detail information about a specific domain product 

* registered to a customer. This form of the lookup domain 

* command will also retrieve the status of the domain while 
30 * it is being processed or after it has failed. 

* <BR><PRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PR0PERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
35 ATTR_DOMAIN_NAME 

ATTR_TECH_CONTACT_ID 
ATTR_HOST_NAMEl 
ATTR_H0ST_ADDR1 
ATTR_HOST_IDl 
40 ATTR_HOST_NAME2 

ATTR_HOST_ADDR2 
ATTR_HOST_ID2 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 
45 * ©param pCustomerPassword the parameter value 

* ©param pDomainName the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale, toolkit . javaapi .NSIWholesaleException when 
50 unable to complete command 

* ©see NSIWhole6aleAPI#C0MMAND_L00KUP 

* ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBO_LOOKUP_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 
55 * ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 

* ©see NSIWholesaleAPI#PARM DOMAIN NAME 
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* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#OBJECT_NOT_FOUND 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see WSPResponse#COMMAND__EXECUTION_SUCCEEDED_TEXT_BEING_RETURNED 

*/ 

public WSPResponse lookupDomain ( 
String pCustomer Account Id, 
String pCustomer Pas sword, 
String pDomainName, 
Properties optionalAttributes) 
throws NSIWholesaleException { 
return lookupDomain ( 

pCus tomerAccount Id , 

pCustomerPassword, 

pDomainName, 

optionalAttributes, 

0); 

} 

protected WSPResponse lookupDomain ( 
String pCustomer Account Id, 
String pCustomerPassword, 
String pDomainName, 
Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + 11 . lookupDomain (String, String, 
String, Properties, int) "; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool . checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

proper tiesCat (allParmsAndAttrs, optionalAttributes); 

al lParmsAndAttrs . put ( PARM_CUSTOMERJ\CCOUNT_ID , 
pCus tomerAccount Id) ; 

allParmsAndAttrs . put ( PARM_CUSTOMER_PAS SWORD , 
pCustomerPassword) ; 

allParmsAndAttrs .put ( PARM_DOMAIN_NAME , pDomainName) ; 

returnCode = conn.makeRequest (COMBO_LOOKUP_DOMAIN, 

allParmsAndAttrs) ; 

pool . checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

} 
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catch (ResourceException re) { 

System. err. print In (methodName + "Caught 
ResourceException" + re) ; 

} 

5 finally { 

return lookupDomain ( 

pCustomerAccountld, 
pCustomer Pas sword , 
pDomainName, 

10 optionalAttributes, 

count + 1) ; 

} 

} 

} 

15 

/** 

* Retrieves a list of the customer's domain products 

* for which the technical contact id is the technical contact. 
20 * <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED__PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
DomainNamel : 

25 DomainName2: 

DomainName3 : 
. . .etc. . . 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 
30 * ©param pTechContactld the parameter value 

* ©param pTechContactPassword the parameter value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleExcept ion when 
unable to complete command 

35 * ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBO_LOOKUP_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_TECH_CONTACT_ID 

40 * ©see NS I Whole sale API #PARMJTECH_CONTACT_PAS SWORD 

★ 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO__DATA__BEING_RETURNED 

* ©see 

45 WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
★ 

*/ 

public WSPResponse lookupDomainByTechContact ( 
String pCustomerAccountld, 
50 String pTechContactld, 

String pTechContactPassword) 
throws NSIWholesaleException { 

return lookupDomainByTechContact ( 
pCustomerAccountld, 
55 pTechContactld, 

pTechContactPassword, 
new Properties () , 
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0) ; 

} 

j ** 

* Retrieves a list of the customer's domain products 

5 * for which the technical contact id is the technical contact. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EX ECUT I ON_S UCC E ED E D_PRO P ERT I ES_B E I NG_RETURNE D 
Expected Result Property Key(s) Returned: 
10 DomainNamel: 

DomainName2 : 
DomainName3 : 
. . .etc. . . 

* </PRExBR> 

15 * ©param pCustomerAccountld the parameter value 

* ©param pTechContactld the parameter value 

* ©param pTechContactPassword the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

20 * ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 

unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASSJ30MAIN 

* ©see NSIWholesaleAPI#COMBO_LOOKUP_DOMAIN 

25 * ©see NSI Whole sale API #PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARMJTECH_CONTACT_ID 

* ©see NSIWholesaleAPI#PARM_TECH_CONTACT_PASSWORD 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

30 * ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* ©see 

WSPResponse#COMMAND_EXECtTTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
*/ 

35 public WSPResponse lookupDomainByTechContact ( 

String pCustomerAccountld, 
String pTechContactld, 
String pTechContactPassword, 
Properties optionalAttributes) 
40 throws NSIWholesaleException { 

return lookupDomainByTechContact ( 
pCustomerAccountld, 
pTechContactld, 
pTechContact Password , 
45 optionalAttributes, 

0) ; 

} 

protected WSPResponse lookupDomainByTechContact ( 
String pCustomerAccountld, 
50 String pTechContactld, 

String pTechContactPassword, 
Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 
55 String methodName = className + 

" . lookupDomainByTechContact (String, String, String, Properties, int) " ; 
if (count > retry) { 
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10 



throw new NSIWholesaleException (methodName + "Unable to 
complete command " ) ; 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool . checkout ( ) ; 
Properties allParmsAndAttrs = new Properties {) ? 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 



allParmsAndAttrs. put (PARM_CUSTOMER_ACCOUNT_ID, 

15 pCustomerAccountld) ; 

allParmsAndAttrs .put ( PARM_TECH_CONTACT_ID , pTechContactld) ; 
allParmsAndAttrs .put (PARM_TECH_CONTACT_PAS SWORD, 
pTechContactPassword) ; 

20 returnCode = conn.makeRequest (COMBO__LOOKUP_DOMAIN, 

allParmsAndAttrs) ; 

pool. checkln( conn) ; 
return returnCode; 
} catch (Exception e) { 
25 try { 

pool . release (conn) ; 

catch (ResourceException re) { 

System. err. print In (methodName + "Caught 
30 ResourceException" + re) ; 

} 

finally { 

return lookupDomainByTechContact ( 
pCustomerAccountld, 
35 pTechContactld, 

pTechContactPassword, 
optionalAttributes , 
count + 1) ; 

} 

40 } 
} 

/ ** 

45 * Retrieves details of a specific domain product owned by customer, 

* for which the technical contact id is the technical contact for 

* the specific product. 

* <BR><PRE> 

Expected Major Result Code: 
50 COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

Expected Result Property Key(s) Returned: 
ATTR_DOMAIN_NAME 
ATTR_TE CH_CONTACT_I D 
ATTR__H0ST_NAME1 
55 ATTR_HOST_ADDRl 

ATTR_H0ST_ID1 
ATTR HOST NAME2 
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ATTR_HOST_ADDR2 
ATTR_HOST_ID2 

* </PRExBR> 

* ©param pCustomer Account Id the parameter value 
5 * ©param pTechContactld the parameter value 

* ©param pTechContactPassword the parameter value 

* ©param pDomainName the parameter value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi . NSIWholesaleExcept ion when 
10 unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASSJDOMAIN 

* ©see NSIWholesaleAPI#COMB0_L00KUP_D0MAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 
15 * ©see NSIWholesaleAPI#PARM_TECH_CONTACT_ID 

* ©see NSIWholesaleAPI#PARMJTECH_CONTACT_PASSWORD 

* ©see NS I Who 1 e s a 1 e AP I # PARM_DOMAI N_NAME 
* 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 
20 * ©see 

WS PRe spons e# COMMAND_EXECUT ION_SUCCEEDED_PROPERTI ES_B E ING_RETURNED 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_TEXT_BEING_RETURNED 
* 

*/ 

25 public WSPResponse lookupDomainByTechContact ( 

String pCustomer Ac count Id, 
String pTechContactld, 
String pTechContactPassword, 
String pDomainName) 
30 throws NSIWholesaleException { 

return lookupDomainByTechContact ( 
pCus t omerAc count Id , 
pTechContactld, 
pTechContact Pas sword , 
35 pDomainName , 

new Properties () , 
0); 

} 

I ★* 

40 * Retrieves details of a specific domain product owned by customer, 

* for which the technical contact id is the technical contact for 

* the specific product. 

* <BRxPRE> 

Expected Major Result Code: 
45 COMMAND_EXECUTION_SUCCEEDED__PROPERTIES_BEING_RETURNED 

Expected Result Property Key(s) Returned: 

ATTR__DOMAIN_NAME 

ATTR_TECH_CONTACT_ID 

ATTR_H0ST_NAME1 
50 ATTR_H0ST_ADDR1 

ATTR_H0ST_ID1 

ATTR_HOST_NAME 2 

ATTR_HOST_ADDR2 

ATTR_HOST_ID2 
55 * </PRExBR> 

* ©param pCustomer Account Id the parameter value 

* ©param pTechContactld the parameter value 
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* ©param pTechContactPassword the parameter value 

* ©param pDomainName the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

5 * ©exception nsi .wholesale . toolkit . javaapi . NSIWholesaleException when 

unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSlWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBO_LOOKUP_DOMAIN 

10 * ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_TECH_CONTACT_ID 

* ©see NSIWholesaleAPI#PARMJTECH_CONTACTJ>ASSWORD 

* ©see NS I Who 1 e s a 1 e AP I # PARM_DOMAI N_NAME 
* 

15 * ©see WSPResponse#GENERAL_ACCESS__DENIED 

* ©see 

WSPResponse#COr4MAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see WSPResponse#COMMAND_EXECuTION_SUCCEEDED_TEXT_BEING_RETURNED 

20 */ 

public WSPResponse lookupDomainByTechContact ( 
String pCustomerAccountld, 
String pTechContactld, 
String pTechContactPassword, 
25 String pDomainName, 

Properties optionalAttributes) 
throws NSIWholesaleException { 

return lookupDomainByTechContact ( 
pCu s t ome r Ac c oun 1 1 d , 
30 pTechContac t Id , 

pTe chCon t ac t Pa s sword , 
pDomainName, 
optionalAttributes , 
0) ; 

35 } 

protected WSPResponse lookupDomainByTechContact ( 
String pCustomerAccountld, 
String pTechContactld, 
String pTechContactPassword, 
40 String pDomainName, 

Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + 
45 ".lookupDomainByTechContact (StringX4, Properties, int) 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 

complete command"); 

} 

50 NSIWholesaleConnection conn = null; 

WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool. checkout () ; 
55 Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 
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propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

allParmsAndAttrs .put (PARM_CUSTOMER_ACCOUNT_ID, 
pCustomer Account Id) ; 

5 allParmsAndAttrs. put (PARM_TECH_CONTACT_ID, pTechContactld) ; 

allParmsAndAttrs .put ( PARM_TECH_CONTACT_PAS SWORD, 

pTechContactPassword) ; 

allParmsAndAttrs. put (PARM_DOMAIN_NAME, pDomainName) ; 

10 returnCode * conn.makeRequest (COMBO_LOOKUP_DOMAIN, 

allParmsAndAttrs) ; 

pool . checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
15 try { 

pool . release (conn) ; 

} 

catch (ResourceException re) { 

System. err .print In ( met hodName + "Caught 
20 ResourceException" + re) ; 

} 

finally { 

return lookupDomainByTechContact ( 
pCustomerAccountld, 
25 pTechCont ac t Id , 

pTechContactPassword, 
pDomainName , 
optionalAttributes, 
count + 1) ; 

30 } 

} 



35 /** 

* Retrieves a list of all domain names associated with 

* DNS Hosting products owned by customer. 

* <BR><PRE> 

Expected Major Result Code: 
40 COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

Expected Result Property Key(s) Returned: 

DomainNamel : 

DomainName2 : 

DomainName3 : 
45 . . .etc. . . 

* </PRExBR> 

* ©param pCustomer Account Id the parameter value 

* ©param pCustomer Pas sword the parameter value 

* ©return the Wholesale Server Protocol Server response 

50 * ©exception nsi. wholesale, toolkit . javaapi .NSIWholesaleExcept ion when 

unable to complete command 

* ©see NSJWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASSJDNS_HOSTTNG 

* ©see NSIWholesaleAPI#COMBO_LOOKUP_DNS_HOSTING 
55 * ©see NSIWholesaleAPI#PARM_CUSTOMER_ACC0UNT_ID 

* ©see NSIWholesaleAPI#PARM CUSTOMER PASSWORD 
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* ©see WSPResponse#GENERAL_ACCESS_pENIED 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* ©see 

WSPResponse#COMMAND_EXECUTlON_SUCCEEDED_PROPERTIES_BEING_RETURNED 
★ 

*/ 

public WSPResponse lookupDnsHosting ( 
String pCustomer Account Id, 
String pCustomer Password) 
throws NSlWholesaleException { 
return lookupDnsHosting ( 
pCustomerAccountld, 
pCustomerPassword, 
new Properties () , 
0); 

} 

/** 

* Retrieves a list of all domain names associated with 

* DNS Hosting products owned by customer. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
DomainNamel: 
DomainName2 : 
DomainName3 : 
. . .etc. . . 

* </PRE><BR> 

* ©param pCustomerAccountld the parameter value 

* ©param pCustomerPassword the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSlWholesaleException when 
unable to complete command 

* ©see NSlwholesaleAPl#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_DNS_HOSTING 

* ©see NSIWholesaleAPI#COMBO_LOOKUP_DNS_HOSTING 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 
* 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WS PRe spons e #C0MMAND_EXECUT I ON_SUCCEEDED_NO_DATA_B E ING_RETURNED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
* 

*/ 

public WSPResponse lookupDnsHosting ( 
String pCustomerAccountld, 
String pCustomerPassword, 
Properties optionalAttributes) 
throws NSlWholesaleException { 
return lookupDnsHosting ( 

pCustomerAccountld, 

pCus tomer Pas sword , 

optionalAttributes , 

0); 
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protected WSPResponse lookupDnsHosting ( 
String pCustomer Account Id, 
String pCustomerPassword, 
Properties optionalAttributes, 
5 int count) 

throws NSIWholesaleException { 

String methodName = className + " . lookupDnsHosting (String , String, 
Properties, int) "; 

if (count > retry) { 

10 throw new NSIWholesaleException (methodName + "Unable to 

complete command"); 

) 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

15 

try { 

conn = (NSIWholesaleConnection) pool . checkout ( ) ; 
Properties allParmsAndAttrs = new Properties () ; 

20 // put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

allParmsAndAttrs .put (PARM_CUSTOMER_ACCOUNT_ID, 
pCustomerAccountld) ; 
25 allParmsAndAttrs .put ( PARM_CUSTOMER_PAS SWORD, 

pCustomerPassword) ; 

returnCode = conn. makeRequest (COMBO__LOOKUP_DNS_HOS TING, 

allParmsAndAttrs) ; 
30 pool .checkln (conn) ; 

return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

35 } 

catch (ResourceException re) { 

System. err. print In (methodName + "Caught 
ResourceException" + re) ; 

} 

40 finally { 

return lookupDnsHosting ( 
pCustomerAccountld, 
pCustomerPassword, 
optionalAttributes , 
45 count + 1) ; 

} 

} 

} 

50 

/** 

* Retrieves details of a specific 

* DNS Hosting product owned by customer. 

* Used, to verify a domain name is part of a DNS Hosting Product 
55 * <BRxPRE> 

Expected Major Result Code: 
COMMAND EXECUTION SUCCEEDED PROPERTIES BEING RETURNED 
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Expected Result Property Key.(s) Returned: 
ATTR_DOMAIN_NAME 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 
5 * ©param pCustomerPassword the parameter value 

* ©param pDomainName the parameter value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi. wholesale. toolkit . javaapi . NSIWholesaleException when 
unable to complete command 

10 * ©see NSIWholesaleAPI#COMMAND_L00KUP 

* ©see NSIWholesaleAPI#CLASS_DNS_HOSTING 

* ©see NSIWholesaleAPI#COMB0_L00KUP_DNS_H0STING 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 
15 * ©see NS I Whol esal eAP I # PARM_DOMAIN_NAME 

★ 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#OBJECT_NOT_FOUND 

* ©see 

20 WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_TEXT_BEING_RETlJRNED 

*/ 

public WSPResponse lookupDns Hosting ( 
25 String pCustomerAccountld, 

String pCustomerPassword, 
String pDomainName) 
throws NSIWholesaleException { 
return lookupDnsHosting ( 
30 pCus t ome r Ac coun 1 1 d , 

pCustomerPassword, 
pDomainName, 
new Properties 0 , 
0) ; 

35 } 

/** 

* Retrieves details of a specific 

* DNS Hosting product owned by customer. 

* Used to verify a domain name is part of a DNS Hosting Product 
40 * <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION — SUCCEEDED_PROPERTIES_BEING — RETURNED 
Expected Result Property Key{s) Returned: 
ATTR_DOMAIN_NAME 
45 * </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pCustomerPassword the parameter value 

* ©param pDomainName the parameter value 

* ©param optionalAttributes a property list of optional attributes 
50 * ©return the Wholesale Server Protocol Server response 

* ©exception nsi . wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSlWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_DNS_HOSTING 

55 * ©see NSIWholesaleAPI#COMBO_LOOKUP_DNS_HOSTING 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 
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* ©see NSIWholesaleAPI#PARMJDOMAINJJAME 
* 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#OBJECT_NOT_FOUND 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see WS PRe spons e # COMMAND_EXECUT ION_S UCCEEDED_TEXT_BE ING_RETURNED 

*/ 

public WSPResponse lookupDnsHosting ( 
String pCustomer Account Id, 
String pCustomerPassword, 
String pDomainName, 
Properties optionalAttributes) 
throws NSIWholesaleException { 
return lookupDnsHosting ( ■ 

pCustomerAccountld, 

pCus tome rPas sword, 

pDomainName, 

optionalAttributes , 

0); 

} 

protected WSPResponse lookupDnsHosting ( 
String pCustomerAccountld, 
String pCustomerPassword, 
String pDomainName, 
Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + ". lookupDnsHosting (String, String, 
String, Properties, int) " ; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool . checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

ailParmsAndAttrs .put (PARM_CUSTOMER_ACCOUNT_ID, 
pCustomerAccountld) ; 

allParmsAndAttrs .put (PARM_CUSTOMER_P AS SWORD, 
pCustomerPassword) ; 

allParmsAndAttrs .put { PARM_DOMAIN_NAME , pDomainName) ; 

returnCode = conn. make Reques t (COMB0_L0OKUP_DNS_HOS TING, 

allParmsAndAttrs) ; 

pool . checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 
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pool .release (conn) ; 

} 

catch (ResourceException re) { 

System. err .print In (methodName + "Caught 
5 ResourceException" + re) ; 

} 

finally { 

return lookupDns Ho sting ( 
pCus tomerAccount Id , 
1 0 pCus tomer Pas sword , 

pDomainName, 
optionalAttributes , 
count + 1) ; 

} 

15 } 

} 



20 * Retrieves a list of all individual accounts linked to a wholesaler. 

* <BR><PRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
25 CustomerAccountldl : 

CustomerAccountId2 : 
Cus tomer Ac count Id3 : 
. . .etc. . . 

* </PRExBR> 

30 * ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_INDIVIDUAL_ACCOUNT 

35 * ©see NSIWholesaleAPI#COMBO_LOOKUP_INDIVIDUAL_ACCOUNT 

* 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED__NO_DATA_BEING_RETURNED 

* ©see 

WSPResponse#COMMAND - EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

40 

*/ 

public WSPResponse lookupIndividualAccount ( ) 
throws NSIWholesaleException { 

return lookupIndividualAccount ( 
45 new Properties () , 

0) ; 

} 

/** 

* Retrieves a list of all individual accounts linked to a wholesaler. 
50 * <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
CustomerAccountldl : 
55 CustomerAccountId2 : 

CustomerAccountId3 : 
. . .etc. . . 
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* </PRExBR> 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi . wholesale . toolkit . javaapi . NSIWholesaleException when 
5 unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_INDIVIDUAL_ACCOUNT 

* ©see NSIWholesaleAPI#COMBO__LOOKUP__INDIVIDUAL_ACCOUNT 
* 

10 * ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING__RETURNED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
* 

*/ 

15 public WSPResponse lookupIndividualAccount ( 

Properties optionalAttributes) 
throws NSIWholesaleException { 

return lookupIndividualAccount ( 
optionalAttributes , 
20 0); 
} 

protected WSPResponse lookupIndividualAccount ( 
Properties optionalAttributes, 
int count) 

25 throws NSIWholesaleException { 

String methodName = className + 
" . lookupIndividualAccount (Properties, int) 11 / 
if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
30 complete command"); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

35 try { 

conn = (NSIWholesaleConnection) pool . checkout ( ) ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 
40 propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

returnCode = 

conn.makeRequest ( COMBO JLO0KUP_INDIVIDUAL_ACCOUNT, allParmsAndAttrs) ; 
pool .checkln (conn) ; 
45 return returnCode; 

} catch (Exception e) { 
try { 

pool . release (conn) ; 

50 catch (ResourceException re) { 

System, err. println (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

55 return lookupIndividualAccount ( 

optionalAttributes , 
count + 1) ; 
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J it * 

* Retrieves details of a specific individual customer account. 

* <BRxPRE> 

Expected Major Result Code: 
10 COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

Expected Result Property Key(s) Returned: 

ATTR_FIRST_NAME 

ATTR_LAST_NAME 

ATTR_PHONE 

1 5 ATTR_AUTH_QUESTION 

ATTR_AUTH_ANSWER 
ATTR_FAX 
ATTRJBMAIL 
ATTR_ADDRESS1 

20 ATTR_ADDRES S 2 

ATTR__ADDRESS 3 
ATTR_ADDRESS4 
ATTR_ADDRESS5 
ATTR_CITY 

25 ATTR_STATE 

ATTR_POSTAL_CODE 
ATTR_COUNTRY_CODE 

* </PRExBR> 

* ©param pCustomer Account Id the parameter value 
30 * ©param pCustomerPas sword the parameter value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale. toolkit . javaapi .NSIWholesaleExcept ion when 
unable to complete command 

* ©see NSIWholesaleAPl#COMMAND_L00KUP 

35 * ©see NSIWholesaleAPI#CLASS_INDIVIDUAL_ACCOUNT 

* ©see NSIWholesaleAPI#COMBO_LOOKUP_INDIVIDUAL_ACCOUNT 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 
* 

40 * ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
* 

*/ 

45 public WSPResponse lookupIndividualAccount ( 

String pCustomer Account Id, 
String pCustomerPassword) 
throws NSIWholesaleException { 

return lookupIndividualAccount ( 
50 pCustomer Account Id, 

pCustomerPassword, 
new Properties () , 
0); 

} 

55 /** 

* Retrieves details of a specific individual customer account. 

* <BR><PRE> 
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Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
ATTR_FIRST_NAME 
5 ATTR_LAST_NAME 

ATTR_PHONE 
ATTR_AUTH_QUESTION 
ATTR_AUTH_ANSWER 
ATTR_FAX 

10 ATTR_EMAIL 

ATTR_ADDRESS1 
ATTR_ADDRESS2 
ATTR_ADDRE S S 3 
ATTR_ADDRESS4 

15 ATTR_ADDRESS5 

ATTR_CITY 

ATTR_STATE 

ATTR_POSTAL_CODE 

ATTR_COUNTRY_CODE 
20 * </PRExBR> 

* ©param pCustomer Account Id the parameter value 

* ©param pCustomerPassword the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

25 * ©exception nsi . wholesale . toolkit . javaapi .NSIWholesaleException when 

unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_INDIVIDUAL_ACCOUNT 

* ©see NSIWholesaleAPI#COMBO_LOOKUP_INDIVIDUAL_ACCOUNT 
30 * ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 
* 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see 

35 WSPResponse#COMMAND_EXECUTI0N_SUCCEEDED_PR0PERTIES_BEING_RETURNED 
* 

*/ 

public WSPResponse lookupIndividualAccount ( 
String pCustomer Ac count Id, 
40 String pCustomerPassword, 

Properties optionalAttributes) 
throws NSIWholesaleException { 

return lookupIndividualAccount ( 
p Cu s t ome r Ac c oun 1 1 d , 
45 pCus tomer Pas sword , 

optionalAttributes , 
0); 

} 

protected WSPResponse lookupIndividualAccount ( 
50 String pCustomer Ac count Id, 

String pCustomerPassword, 
Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 
55 String methodName = className + lookupIndividualAccount (String, 

String, Properties, int) " ; 

if (count > retry) { 
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throw new NSIWholesaleException (methodName + "Unable to 
complete command") ; 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool . checkout { ) ; 
Properties allParmsAndAttrs = new Properties {) ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, opt ionalAt tributes) ; 

al lParmsAndAtt rs . put ( PARM_CUSTOMER_ACCOUNT_ID , 
pCustomerAccountld) ; 

al lParmsAndAt trs . put ( PARM_CUSTOMER_PAS SWORD , 
pCustomerPassword) ; 

returnCode = 

conn.makeRequest (COMBO_LOOKUP_INDIVIDUAL_ACCOUNT, allParmsAndAttrs) ; 
pool . checkln (conn) ; 
return returnCode ; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

catch (ResourceException re) { 

System. err .print In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return lookupIndividualAccount ( 
pCu s t ome r Ac count I d , 
pCustomerPassword, 
opt ionalAt tributes , 
count + 1) ; 

} 

} 

} 



/** 

* Retrieves a list of all business customer accounts linked to 
wholesaler. 

* <BR><PRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 

CustomerAccountldl : 

CustomerAccountId2 : 

CustomerAccountId3 : 

. . .etc. . . 

* </PRExBR> 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 
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* ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_BUSINESS_ACCOUNT 

* ©see NSIWholesaleAPI#COMBO_LOOKUP_BUSINESS_ACCOUNT 
* 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED__NO_DATA_BEING_RETURNED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
*/ 

public WSPResponse lookupBusinessAccount ( ) 
throws NSIWholesaleException { 

return lookupBusinessAccount ( 
new Properties () , 
0) ; 

} 

/** 

* Retrieves a list of all business customer accounts linked to 
wholesaler. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 

CustomerAccountldl : 

CustomerAccountId2 : 

Customer Account Id3 : 

. . .etc. . . 

* </PRExBR> 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale, toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_BUSINESS_ACCOUNT 

* ©see NSIWholesaleAPI#COMBO_LOOKUP_BUSINESS_ACCOUNT 
* 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA__BEING_RETURNED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
* 

*/ 

public WSPResponse lookupBusinessAccount ( 

Properties optionalAttributes) 
throws NSIWholesaleException { 

return lookupBusinessAccount ( 
optionalAttributes , 
0) ; 

} 

protected WSPResponse lookupBusinessAccount ( 
Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + 
" . lookupBusinessAccount (Properties, int) " ; 
if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 
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NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 



try { 



10 

allParmsAndAttrs) ; 



conn o (NSIWholesaleConnection) pool . checkout ( ) ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 
returnCode = conn .make Re quest (COMBO_LOOKU P_BUS I NESS_ACCOUNT, 



pool. checkln( conn) ; 
return returnCode; 
15 } catch (Exception e) { 

try { 

pool . release (conn) ; 

catch (ResourceException re) { 
20 System. err. print In (methodName + "Caught 

ResourceException" + re) ; 

} 

finally { 

return lookupBusinessAccount ( 
25 optionalAttributes , 

count + 1) ; 

} 

} 

} 

30 

/** 

* Retrieves details of a specific business customer account. 

* <BRxPRE> 

35 Expected Major Result Code: 

COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING — RETURNED 
Expected Result Property Key(s) Returned: 

ATTR_COMPANY_NAME 

ATTR_COMPANY_TYPE 
40 ATTR_EMAIL 

ATTR_PHONE 

ATTR_FAX 

ATTR__ADDRES S 1 

ATTR_ADDRESS2 

45 ATTR_ADDRESS3 

ATTR_ADDRES S 4 
ATTR_ADDRE S S 5 
ATTR_CITY 
ATTR_STATE 

50 ATTR_POSTAL_CODE 

ATTR_COUNTRY_CODE 

ATTR_LEGAL_CONTACT_FIRST_NAME 

ATTR_LEGAL_CONTACT_LAST_NAME 

ATTR_LEGAL_CONTACT_PHONE 
55 ATTR_LEGAL_CONTACT_FAX 

ATTR_LEGAL_CONTACT_EMA I L 

ATTR LEGAL CONTACT CITY 
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ATTR_LEGAL_CONTACT_STATE 
ATTR_LEGAL_CONTACT_POSTAL_CODE 
ATTR_LEGAL_CONTACT_COUNTRY_CODE 
ATTR_LEGAL_CONTACT_ADDRESS 1 
5 ATTR_LEGAL_CONTACT_ADDRES S 2 

ATTR_LEGAL_CONTACT_ADDRESS 3 
ATTR_LEGAL__CONTACT_ADDRESS 4 
ATTR_LEGAL_CONTACT__ADDRES S 5 

* </PRExBR> 

10 * ©param pCustomerAccountld the parameter value 

* ©param pCustomerPassword the parameter value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale. toolkit . javaapi .NSIWholesaleExcept ion when 
unable to complete command 

15 * ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_BUSINESS_ACCOUNT 

' * ©see NSIWholesaleAPI#COMBO_LOOKUP_BUSINESS_ACCOUNT 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 

20 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING__RETURNED 

25 */ 

public WSPResponse lookupBusinessAccount ( 
String pCustomerAccountld, 
String pCustomerPassword) 
throws NSIWholesaleException { 
30 return lookupBusinessAccount ( 

pCustomerAccountld, 
pCus tome r Pas sword , 
new Properties () , 
0) ; 

35 } 

I ** 

* Retrieves details of a specific business customer account. 

* <BRxPRE> 

Expected Major Result Code: 
40 COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

Expected Result Property Key(s) Returned: 

ATTR_COMPANY_NAME 

ATTR_COMPANY_TYPE 

ATTR_EMAIL 

45 ATTR_PHONE 

ATTR_FAX 
ATTR_ADDRESS1 
ATTR_ADDRESS2 
ATTR_ADDRESS3 

50 ATTR_ADDRESS4 

ATTR_ADDRESS5 

ATTR_CITY 

ATTR_STATE 

ATTR_POSTAL_C0DE 
55 ATTR_COUNTRY__CODE 

ATTR_LEGAL_CONTACT_FIRST_NAME 

ATTR LEGAL CONTACT LAST NAME 
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* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pCustomer Pas sword the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi . wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_BUSINESS_ACCOUNT 

* ©see NSIWholesaleAPi'#COMBO_LOOKUP_BUSINESS_ACCOUNT 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 
* 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 



public WSPResponse lookupBusinessAccount ( 
String pCustomerAccountld, 
String pCustomerPassword, 
Properties optionalAttributes) 
throws NSIWholesaleException { 

return lookupBusinessAccount ( 

pCus tomerAccount Id , 

pCustomerPassword, 

opt ionalAttributes , 

0); 

} 

protected WSPResponse lookupBusinessAccount ( 
String pCustomerAccountld, 
String pCustomerPassword, 
Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + '* . lookupBusinessAccount (String, 
String, Properties, int) " ; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 
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conn = (NSIWholesaleConnection) pool .checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 
5 propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

allParmsAndAttrs .put (PARM_CUSTOMER_ACCOUNT_ID, 
pCustomerAccountld) ; 

allParmsAndAttrs .put (PARM_CUSTOMER_P AS SWORD, 
10 pCustomerPassword) ; 

returnCode = conn.makeRequest (COMBO_LO0KUP_BUSINESS_ACC0UNT, 

allParmsAndAttrs) ; 

pool. checkln (conn) ; 
15 return returnCode; 

} catch (Exception e) { 
try { 

pool . release (conn) ; 

} 

20 catch (ResourceException re) { 

System. err .print In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

25 return lookupBusinessAccount ( 

pCus tomer Ac count I d , 
pCustomerPassword , 
optionalAttributes , 
count + 1) ; 

30 } 

} 

} 

35 /** 

* Retrieves details of a specific technical contact. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PRO PERTI ES_B E ING_RETURNED 
40 Expected Result Property Key(s) Returned: 

ATTR_ORGANI ZATION 

ATTR_PHONE 

ATTR_FAX 

ATTR_EMAIL 
45 ATTR__ADDRESS1 

ATTR_CITY 

ATTR_STATE 

ATTR_POSTAL_CODE 

ATTR__COUNTRY_C0DE 
50 * </PRExBR> 

* Oparam pTechContactld the parameter value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

55 * ©see NSlWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_TECHNICAL_CONTACT 

* ©see NSIWholesaleAPI#COMBO_LOOKUP_TECHNICAL_CONTACT 
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* ©see NSIWholesaleAPI#PARMJTECH_CONTACT_ID 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

5 

*/ 

public WSPResponse lookupTechnicalContact { 

String pTechContactld) 
throws NSIWholesaleException { 
10 return lookupTechnicalContact { 

pTechContactld, 
new Properties 0 , 
0) ; 

} 

15 /** 

* Retrieves details of a specific technical contact. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
20 Expected Result Property Key(s) Returned: 

ATTRJDRGANI ZATION 

ATTR_PHONE 

ATTR_FAX 

ATTR_EMAIL 
25 ATTR_ADDRESS1 

ATTR_CITY 

ATTR_STATE 

ATTR_POSTAL_CODE 

ATTR_COUNTRY_CODE 
30 * </PRExBR> 

* ©param pTechContactld the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale, toolkit . javaapi .NSIWholesaleException when 
35 unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_TECHNICAL_CONTACT 

* ©see NSIWholesaleAPI#COMBO_LOOKUP_TECHNICAL_CONTACT 

* ©see NSIWholesaleAPI#PARM__TECH_CONTACT_ID 

40 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
*/ 

45 public WSPResponse lookupTechnicalContact ( 

String pTechContactld, 
Properties optionalAttributes) 
throws NSIWholesaleException { 

return lookupTechnicalContact ( 
50 pTechContactld, 

optionalAttributes , 
0); 

} 

protected WSPResponse lookupTechnicalContact ( 
55 String pTechContactld, 

Properties optionalAttributes, 
int count) 
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10 



throws NSIWholesaleException { 

String methodName = className + " . lookupTechnicalContact (String, 
Properties, int) " ; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnect ion) pool. checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 

15 // put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

allParmsAndAttrs .put (PARM_TECH_CONTACT_ID, pTechContactld) ; 

20 returnCode = 

conn . makeRequest (COMBOJX)OKUPJTECHNICAIi_CONTACT, allParmsAndAttrs) ; 
pool . checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
25 try { 

pool . release (conn) ; 

} 

catch (ResourceException re) { 

System. err .print In (methodName + "Caught 
30 ResourceException" + re) ; 

} 

finally { 

return lookupTechnicalContact ( 
pTechContactld, 
35 optionalAttributes, 

count + 1) ; 

} 

} 

} 

40 

I ** 

* This method returns basic information about the supported 

* protocol commands and classes . 
45 * <BR><PRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_TEXT_BEING_RETURNED 
Expected Text Returned: 

. . .The Help Text . . . 
50 Expected Result Property Key(s) Returned: 

textl : 
text2 : 
text3 : 
. . . etc . . . 
55 * </PRExBR> 

* ©return the Wholesale Server Protocol Server response 
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* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see WSPResponse#getProperties 

* ©see NSIWholesaleAPI#COMMAND_HELP 

5 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_TEXT_BEING_RETURNED 
* 

*/ 

public WSPResponse helpO 
10 throws NSIWholesaleException { 

return help ( 

new Properties () , 
0); 

} 

15 /** 

* This method returns basic information about the supported 

* protocol commands and classes . 

* <BRxPRE> 

Expected Major Result Code: 
20 COMMAND_EXECUTION_SUCCEEDED_TEXT_BEING_RETURNED 

Expected Text Returned: 

. . .The Help Text. . . 
Expected Result Property Key(s) Returned: 
textl: 

25 text2 : 

text3 : 
. . . etc . . . 

* </PRExBR> 

* ©param optionalAttributes a property list of optional attributes 
30 * ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale. toolkit .javaapi .NSIWholesaleException when 
unable to complete command 

* ©see WSPResponse#getProperties 

* ©see NSIWholesaleAPI#COMMAND_HELP 



35 



©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_TEXT_BEING_RETURNED 



*/ 

public WSPResponse help( 
40 Properties optionalAttributes) 

throws NSIWholesaleException { 
return help( 

optionalAttributes , 
0); 

45 } 

protected WSPResponse help( 

Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 
50 String methodName = className + ". help (Properties, int) " ; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command") ; 

} 

55 NSIWholesaleConnection conn = null; 

WSPResponse returnCode; 
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try { 

conn = (NSIWholesaleConnection) pool. checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAt tributes) ; 
returnCode = conn . makeReques t ( COMMAND_HELP , 

allParmsAndAttrs) ; 

pool . check In (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

catch (ResourceException re) { 

System. err .print In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return help( 

optionalAttributes , 
count + 1) ; 

} 

} 

} 

/** 

* This method terminates the wholesaler's access to session commands. 

* <BR><PRE> 

Expected Major Result Code; COMMAND_SUCCEEDED_CL0SING_CONNECTION 

* </PRExBR> 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleExcept ion when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_QUIT 
. .. . * 

* ©see WSPResponse#COMMAND_SUCCEEDED_CLOSING_CONNECTION 
* 

*/ 

public WSPResponse quitO 
throws NSIWholesaleException { 
return quit ( 

new Properties () , 

0); 

} 

/** 

* This method terminates the wholesaler's access to session commands. 

* <BR><PRE> 

Expected Major Result Code: COMMAND_SUCCEEDED_CLOSING_CONNECTION 

* </PRExBR> 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_QUIT 
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* Osee WSPResponse#COMMAND_SUCCEEDED_CLOSING_CONNECTION 
* 

*/ 

5 public WSPResponse quit( 

Properties optionalAttributes) 
throws NSIWholesaleException { 
return quit{ 

optionalAttributes, 

10 0); 

- } 

protected WSPResponse quit ( 

Properties optionalAttributes, 
int count) 

15 throws NSIWholesaleException { 

String methodName = className + " .quit (Properties , int) " ; 
if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command" ) ; 
20 } 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

25 conn = (NSIWholesaleConnection) pool .checkout () ; 

Properties allParmsAndAttrs = new Properties 0 ; 



30 



// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 



returnCode = conn . makeReque s t ( COMMAND_QUIT , 

allParmsAndAttrs) ; 

pool . checkln (conn) ; 
return returnCode; 
35 } catch (Exception e) { 

try { 

pool . release (conn) ; 

} 

catch (ResourceException re) { 
40 System. err .print In (methodName + "Caught 

ResourceException" + re) ; 

} 

finally { 

return quit ( 

45 optionalAttributes , 

count + 1) ; 

} 

} 

} 

50 //#--END API 



/** 

* This method shutsdown the Wholesaler Services Protocol API. 
55 * ©return void 
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public void shutdown () { 

System . out . println ( "NSIWholesaleAPI . shutdown : " + 

"Calling pool . shutdown ()..."); 
//pool . shutdown ( ) ; 
5 try { 

//pool . close ( ) ; 

pool . close (60000, 60000); 

} 

catch (ResourceException re) { 
10 System, err. println ("Exception Caught: " + re); 

} 

System . out . println ( "NSIWholesaleAPI . shutdown : " + 
"pool . shutdown ( ) returned ! " ) ; 

} 



15 



//***************************★********************************** 

// Support Functions 



/** 

20 * This method parses the string argument as a signed decimal integer 

* ©param valueString the string to be parsed as an int 

* ©return an int representing the valueString 

* ©see java.lang. Integertfparselnt 
* 

25 */ 

protected static int parselnt (String valueString) { 
try { 

return Integer .parselnt (valueString) ; 
} catch (NumberFormatException nfe) { 
30 return 0; 

} 

} 

/** 

35 * This method concatinates the source property list onto the end of the 

* target propery list. Filtering is done to remove properties 
associated with 

* credit card charges. 

* ©param target the target (destination) property list 
40 * ©param source the source property list 

* ©return void 

* ©see java.util. Properties 
* 

*/ 

45 protected static void propertiesCat (Properties target, Properties 

source) { 

String methodName = className + " .propertiesCat (Properties , 
Properties) 11 ; 

50 if ((target == null) || (source == null)) { 

return; 

} 

// concatinate source properties onto target properties 
55 if (source. isEmptyO =- false) { 

try { 

String key; 
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String value; 

Enumeration e = source . proper tyNames () ; 
while (e.hasMoreElements () ) { 

key = (String) e .next Element 0 ; 
5 value = source . getProperty (key) ; 

target. put (key, value); 

} 

} 

catch (NoSuchElementException nsee) { 
10 System. err. println (methodName + 

"Invalid Properties") ; 
nsee . pr intStackTrace ( ) ; 

} 

} 

15 return; 

} 

I ** 

* This method concatinates the source property list onto the end of the 
20 * target propery list. 

* ©param protocol client (your) protocol 

* ©return true if your protocol matches wholesale services protocol, 

* otherwise false 

* ©see NSIWholesaleAPI#ATTR_PROTOCOL 
25 * ©see NSIWholesaleAPl#Describe 

* 

*/ 

protected boolean verifyConnecti'onProtocol (String protocol) 

throws NSIWholesaleException { 

30 String methodName = className + ". verif yConnectionProtocol (String) 

ii . 
* 

WSPResponse wspResponse = describe ( ATTR_P ROTO COL ) ; 
if (wspResponse == null) { 

System. err. print In (methodName + "Unable to verify connection 
35 protocol " + protocol) ; 

return false; 

} 

if ( wspResponse. getMajorResultCode () == 
WSPResponse . COMMAND_EXECUTION__SUCCEEDED_PROPERTIES_BEING_RETURNED) { 
40 String wspProtocol = wspResponse .getProperty (ATTR_PROTOCOL) ; 

if (wspProtocol mm null) { 

System. err .println (methodName + "Unable to verify 
connection protocol " + protocol) ; 

return false; 

45 } 

if (protocol .equals (wspProtocol) ) { 

System. out .println (methodName + "Successfully verified 
connection protocol " + protocol) ; 
50 return true; 

} 

else { 

System. err. print In (methodName + "Failed to verify 

connection protocol: " + 
55 "Your Protocol = <" + protocol + "> while 

Wholesale Services Protocol = <" + wspProtocol + ">"); 

return false; 
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} 

} 

else { 

Sys tern. err. print In (methodName + "Unable to verify connection 
protocol " + protocol) ; 

return false; 



// End of file NSIWholesaleAPI . java 

// Copyright (c) 2000 Network Solutions, Inc 



The class definition for WSPResponse is as follows: 

// 

// Package 

// 

package nsi ♦ wholesale . toolkit . j avaapi ; 

//---- — - 

// Imports . . . 

// 

import java.util .NoSuchElement Except ion; 

import java.util . StringTokenizer ; 

import java.util .Hashtable; 

import java . util .Vector; 

import java.util . Enumeration ; 

import java. util. Properties; 

import j ava . text . * ; 

/** 

* Copyright (c) 2000 Network Solutions, Inc <BR> 

* This class represents the various components of a 

* Wholesale Services Protocol (WSP) Response. 

* A WSP response will be returned for each request that is issued 

* throught the protocol. A response will describe, in as much detail 

* as possible, the outcome of the issued request, and will optionally 

* include any additional information that was generated by the request. 

* A result consists of a 'result code' followed by a descriptive 

* 'result message'. A 'result code' consists of a major result code 

* followed by a period ('.'), followed by a minor result code. 

* The three-digit major result code provides a general indication of 

* the success or failure of an issued request. 

* In most cases, one or more result properties are returned. A result 

* property consists of a property key followed by a colon (':'), 

* followed by a property value. 

* In other cases, plain text is returned (e.g. the information returned 

* from the Help command) . Both of these cases are indicated by specific 

* result codes. 
* 

* ©author David A. Moston 

* ©see NSIWholesaleAPI 
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* ©since 27 July 2000 

* ©version 1-0 
+ 

* 

5 *<BR> <BR> 

* $Log$ 

*<BR> <BR> 

*/ 



public class WSPResponse { 
10 

// - - - 

// Beginning of Required/ Standard Fields 

// ---- - 

/** Serial Version */ 
15 static long serialVersion = 1L; 

/** Release Version */ 
static double version = 1.0D; 

20 /** SCCS control ID */ 

static final String sccsID = "©(#) wholesale- sdk_dl . 12 . 1 . 3 08/04/00 
10:27:15 WSPResponse . j ava NSI"; 

/** JDK Version */ 
25 static String jdkVersion = "1.1. 7" ; 

// Static Accessor Method (s) . . . 

/** Static accessor method to get serial version */ 

static public long getSerialVersion () { return serialVersion; } 

30 

/** Static accessor method to get release version */ 
static public double getVersionO { return version; } 

/** Static accessor method to get JDK version */ 
35 static public String get JdkVersion ( ) { return jdkVersion; } 

// — - ™ 

// End of Required/Standard Fields 

// 

40 // 

// class (static) variable (s) ... 



/** The name of this class */ 

private static final String className = "WSPResponse"; 

/** Ease-of-use constant for Major Result Code: Minimum. 
(Note: this is NOT a valid/ supported major result code) 
All valid/supported major result codes will be 

greater than the minimum and less than the maximum, respectively */ 
public static final int MAJOR_RESULT_C0DE_MIN = 99; 

/** Ease-of-use constant for Major Result Code [General Information]: 
Minimum. 

(Note: this is NOT a valid/ supported major result code) */ 
55 public static final int MAJOR_RESULT_CODE_GENERAL_INFORMATION_MIN = 99; 

/** Ease-of-use constant for Major Result Code [General Information] : 
General information */ 



45 



50 
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10 



15 



20 



25 



30 



35 



40 



45 



50 



55 



public static final int GENE RAL_IN FORMAT I ON = 100; 

/** Ease-of-use constant for Major Result Code [General Information]: 
Maximum. 

(Note: this is NOT a valid/ supported major result code) */ 
public static final int MAJOR_RESULT_CODE_GENERAL_INFORMATION_MAX = 199; 



/** Ease-of-use constant for Major Result Code [Success] : 
(Note: this is NOT a valid/ supported major result code) 
public static final int MAJOR_RESULT_CODE_SUCCESS_MIN = 
/** Ease-of-use constant for Major Result Code [Success] ; 
successful */ 

public static final int AUTHENTICATION_SUCCESSFUL =210; 
/** Ease-of-use constant for Major Result Code [Success] : 



Minimum. 
*/ 

199; 
Authentication 



Session created 



public static final int S E S S I ON_C REATED = 220; 

/** Ease-of-use constant for Major Result Code [Success] 
succeeded, closing connection */ 

public static final int COMMANDOS UCCEEDED_CLOSING_CONNECT ION = 221; 

/** Ease-of-use constant for Major Result Code [Success] : Command 
accepted, now executing */ 

public static final int COMMAND_ACCEPTED_NOW_EXECUTING • 

/** Ease-of-use constant for Major Result Code [Success] 
available */ 

public static final int COMMAND_NOT_AVAILABLE = 231; 

/** Ease-of-use constant for Major Result Code [Success] 
execution succeeded, no data being returned; Ok */ 

public static final int 
COMMAND_EX ECUTI ON_S UCCE ED ED_NO_DATA_B EI NG_RE TURNED = 24 0; 

/** Ease-of-use constant for Major Result Code [Success] 
execution succeeded, properties being returned */ 

public static final int 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING - RETURNED ■ 241; 

/** Ease-of-use constant for Major Result Code [Success] 
execution succeeded, text being returned */ 

public Static final int COMMAND_EXECUTION_SUCCEEDED__TEXT_BEING_RETURNED 



Command 



230; 

Command not 



Command 



Command 



Command 



242; 



/** Ease-of-use constant for Major Result Code [Success] : Maximum. 
(Note: this is NOT a valid/supported major result code) */ 
public static final int MAJOR_RES0TjT_CODE_SUCCESS_MAX = 299; 



Minimum. 
*/ 

299; 
Authentication 



/** Ease-of-use constant for Major Result Code [Failure] 
(Note: this is NOT a valid/ supported major result code) 
public static final int MA J OR_RESULT_CODE_FAI LURE_MIN = 
/** Ease-of-use constant for Major Result Code [Failure] 
failed */ 

public static final int AUTH ENT I CAT I ON_F A I L E D = 310; 

/** Ease-of-use constant for Major Result Code [Failure] : Too many 
connections */ 

public static final int TOO JVIANY_CONNECT IONS = 320; 

/** Ease-of-use constant for Major Result Code [Failure] : Too many 
connections from current wholesaler */ 

public static final int T0OJ*ANY_C0NNECTI0NS_FR0M_CURRENT_WH0LESALER = 

321; 

/** Ease-of-use constant for Major Result Code [Failure] : Wholesaler 
account has been suspened */ 

public static final int WHOLE SALER_ACCOUNT_HAS_BEEN_SUSPENDED = 322; 
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/** Ease-of-use constant for Major Result Code [Failure] : 

out */ 

public static final int SESSI0N_TIMED_OUT = 323; 
/** Ease-of-use constant for Major Result Code [Failure] : 
connection - Command timed out */ 

public static final int SERVER__CLOSING_CONNECTION = 324; 
/** Ease-of-use constant for Major Result Code [Failure] : 



Session timed 



Server closing 



Invalid command 



10 



15 



20 



25 



30 



35 



40 



45 



50 



55 



public static final int INVALID_C0MMAND = 330; 

/** Ease-of-use constant for Major Result Code [Failure] 



Invalid class 



public static final int INVALID_CLASS = 331; 

/** Ease-of-use constant for Major Result Code [Failure] : Formatting 
error */ 

public static final int FORMATTINGJERROR = 332; 

/** Ease-of-use constant for Major Result Code [Failure] : Missing 
required parameter */ 

public static final int MISSINGJ*EQUIRED_PARAMETER = 333; 

/** Ease-of-use constant for Major Result Code [Failure] : Invalid 
attribute */ 

public static final int I NVAL I D_ATTR I BUTE = 334; 

/** Ease-of-use constant for Major Result Code [Failure] : Invalid value 

*/ 

public static final int I NVAL I DEVALUE = 335; 

/** Ease-of-use constant for Major Result Code [Failure] : Missing 
required attribute */ 

public static final int M I S S I NG_REQU I RED_ATTR I BUTE = 336; 

/** Ease-of-use constant for Major Result Code [Failure] : Missing 
required value */ 

public static final int M I S S I NG_REQU I RED_VALUE = 337; 

/** Ease-of-use constant for Major Result Code [Failure] : Missing 
parameter */ 

public static final int INVALID^ PARAMETER = 33 8; 

/** Ease-of-use constant for Major Result Code [Failure] : Command failed, 
unknown error - Command failed, internal error */ 

public static final int COMMAND_FAILEDJUNKNOWN_ERROR = 340; 

/** Ease-of-use constant for Major Result Code [Failure] ; Object not 
found */ 

public static final int OBJECT_NOT_FOUND = 341; 

/** Ease-of-use constant for Major Result Code [Failure] : Command access 
denied */ 

public static final int COMMAND_ACCESS_DENIED = 342; 

/** Ease-of-use constant for Major Result Code [Failure] : General access 
denied - Access to request denied */ 

public Static final int GENERAL_ACCESS_DENIED = 343; 
/** Ease-of-use constant for Major Result Code [Failure] : Maximum. 
(Note: this is NOT a valid/supported major result code) */ 
public static final int MAJOR_RESULT_CODE__FAILURE_MAX = 399; 

/** Ease-of-use constant for Major Result Code: Maximum. 
(Note: this is NOT a valid/supported major result code) 
All valid/ supported major result codes will be 

greater than the minimum and less than the maximum, respectively */ 
public static final int MAJOR_RESULT_CODE__MAX = 400; 



//- 
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// class (static) method(s) ... 

// - 

// - — 

// static initializer block . . . 

// " " - " 

// " 

// instance Variable(s) ... 

// " 

* WSP response result code (consisting of a major result code, 

* followed by a period ('.'), followed by a minor result code). 
*/ 

private String resultCode = null; 
/** 

* WSP response major result code 
*/ 

private int majorResultCode = 0; 
/** 

* WSP response minor result code 
*/ 

private int minorResultCode = 0; 
/** 

* The original WSP text response' string used to instantiate object. 

* The raw WSP response consists of one or more <CRLF> delimited lines, 

* terminated by a line containing only a period { 1 . » ) , followed by 
<CRLF>. 

*/ 

private String rawResponse = null; 
/** 

* The result message extracted from the original WSP text response. 
*/ 

private String resultMessage = null; 

I -k * 

The WSP response attributes extracted from the original WSP 

text response. 

*/ 

private Hashtable attributes = null; 



// 

// Constructors 

// 

* 

* Parses a WSP text response and extracts and stores the 

* various components. 
* 

* ©param data the raw WSP response text 
* 
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* ©exception InvalidArgumentException if <code>data</code> is null. 

* ©exception I nvalidResponseFormat Except ion if <code>data</code> is. 

* not a properly formatted 

* WSP response. 

5 */ 

public WSPResponse (String data) 

throws InvalidArgumentException, InvalidResponseFormatException { 

if (data == null) { 

10 throw new InvalidArgumentException ( "null argument: data"); 

} 



15 



parseRawResponse (data) ; 
setRawResponse (data) ; 

} 

* Create a new WSPResponse based on value inputs. 
★ 

20 * ©param majorCode the major code for the WSPResponse. 

* ©param minorCode the minor code for the WSPResponse. 

* ©param message the text string associated with the message. 

* ©param assocProps the properties associated with this message. 
* 

25 

* ©exception InvalidArgumentException if majorCode or minorCode is or 

* not in the appropriate range. 
*/ 

public WSPResponse (int majorCode, int minorCode/ 
30 String message, Properties assocProps) 

throws InvalidArgumentException { 

if ((majorCode == null) || (minorCode == null) || 

(majorCode < MAJOR_RESULT_CODE_MIN ) | | (majorCode > 
35 MAJORJ*ESULT_CODE_MAX) | | 

(minorCode < 0 ) || (minorCode > 999)) { 

throw new InvalidArgumentException ( "null argument: data"); 

} 

majorResultCode = majorCode; 
40 minorResultCode = minorCode; 

resultMessage = new String (message) ; 
if (assocProps != null) { 

Enumeration enum = assocProps .propertyNames () ; 
while (enum.hasMoreElements () ) { 
45 String prop_key = (String) enum. next Element () ; 

String value = prop . get Property (prop_key) ; 
addAttribute (prop_key, value) ; 

} 

} 

50 DecimalFormat myFmt = new Decimal Format ( ) ; 

myFmt . setMinimumlntegerDigits (3) ; 

myFmt . setMaximumlntegerDigi ts ( 3 ) ; 

myFmt . setMaximumFractionDigits (3) ; 

myFmt . setMinimumFractionDigits (3) ; 
55 double x = majorCode + minorCode/ 1000 . 0 ; 

resultCode = myFmt . format (x) ; 
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// " " "-- 

// Accessors and Mutators 

// " 



* Returns the original WSP text response string used to instantiate 

* object. 

10 

* ©return the original WSP text response. 
*/ 

public String getRawResponse () { 
return rawResponse; 

15 } 

* Returns the result message extracted from the original WSP 

* text response. 

20 

* ©return the WSP response result message. 
*/ 

public String getResultMessage () { 
return resultMessage; 

25 } 

* Returns any attributes, if applicable, extracted from the original 
30 * WSP text response. 

★ 

* ©return response attributes if any exist, null otherwise. 
*/ 

Hashtable getAttributes () { 
35 return attributes; 

} 

/* * 

* returns the result property value corresponding to the specified 
40 * result property key, if found, extracted from the original 

* WSP text response. 

* ©param result PropertyKey a result property key 

* ©return the corresponding result property value, otherwise null 
45 */ 

public String getProperty (String result PropertyKey) { 
String resultPropertyValue = null; 
Hashtable attributes = getAttributes () ; 

50 if (attributes == null) { 

return resultPropertyValue; 

} 



55 



Vector vector = (Vector) attributes .get (resultPropertyKey) 

if (vector == null) { 

return resultPropertyValue; 
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} 

for (int i = 0; i < vector . size () ; i+ + ) { 

resultPropertyValue = (String) vector . elementAt (i) ; 

} 

return resultPropertyValue; 

} 

* 

* Returns a property list containing all result property 
specifications, 

* if applicable, extracted from the original WSP text response. 

* Note: when the major result code = 
COMMAND_EXE CUT 1 0N_S UCCE ED ED_TEXT_B E I NG_RETURNED 

* text is being returned in the response, as opposed to result property 
specifications . 

* Since there are no defined result property keys for returned text, a 

dummy 

* result property key is generated for each line of text. 

* That dummy result property key will look like 1 text# 1 , where # 

* is a number from 1 to N (N being the number of lines of text 
returned) . 

* For example, the first dummy result property key will be 1 textl'. 

* For example, the tenth dummy result property key will be • textlO 1 . 
* 

* 

* ©return response attributes if any exist, null otherwise. 

* ©see WSPResponse#getText 
*/ 

public Properties getProperties () { 

Properties props = new Properties () ; 

Hashtable attributes = getAttributes ( ) ; 

if (attributes == null) { 
return null; 

} 

Enumeration enum = attributes . keys {) ; 

int lineNumber = 0; 

while (enum.hasMoreElements () ) { 

lineNumber++; 

String key = null; 

Vector vector = null; 

key = (String) enum.nextElement () ; 

//if Command execution succeeded; text being returned 
if (getMajorResultCode () == 
COMMAND_EXECUTION_SUCCEEDED_TEXT_BEING_RETURNED) { 

key = "text" + lineNumber; // Create a "dummy" key 

for this line of text 
} 

vector n (Vector) attributes .get (key) ; 
for (int i=0; i < vector . size () ; i++) { 
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props. put (key, (String) vector .elementAt (i) ) ; 

} 

} 

5 return props; 

} 

/** 

* Returns a property list containing all result property 
10 specifications, 

* if applicable, extracted from the original WSP text response. . 

* Note: when the major result code = 
COMMAND_EXE CUT I ON_SUCCEEDED_TEXT_BEING__RE TURNED 

* text is being returned in the response, as opposed to result property 
15 specifications . 

* Since there are no defined result property keys for returned text, a 

dummy 

* result property key is generated for each line of text. 

* That dummy result property key will look like 1 text#', where # 
20 * is a number- from 1 to N (N being the number of lines of text 

returned) . 

* For example, the first dummy result property key will be ' textl'. 

* For example, the tenth dummy result property key will be ' textlO 1 . 
* 

25 * ©param wspResponse the WSP response 

* ©return response attributes if any exist, null otherwise. 

* ©see WSPResponsettgetText 
*/ 

public static Properties getProperties (WSPResponse wspResponse) { 
30 return wspResponse .getProperties () ; 

} 

/** 

* returns a vector containing lines of text returned in the WSP 
35 response. 

* Note: when the major result code is 
COMMAND__EXECUTION_SUCCEEDED_TEXT_BEING_RETURNED, 

* text is being returned in the response, as opposed to result property 
specifications . 

40 * There are no result property keys defined for text. 

* This method returns a vector of Strings. Each element (String) in 
the vector is a line of text. 

* 

* ©param wspResponse the WSP response 

45 

* ©return a vector containing lines of text returned, otherwise null 

* ©see WSPResponse#get Properties 
*/ 

public Vector getText () { 
50 Vector text = new Vector ( ) ; 

//if not: Command execution succeeded; text being returned 
if (getMajorResultCode 0 != 
COMMAND_EXECUTION_SUCCEEDEDJTEXT_BEING_RETURNED) { 
55 return null; 

} 
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Hashtable attributes = getAttributes ( ) ; 

if (attributes == null) { 
return null; 

} 

Enumeration enum = attributes . keys () ; 

int lineNumber = 0; 

while (enum.hasMoreElements 0 ) { 

lineNumber++; 

String key = null; 

Vector vector = null; 

key = (String) enum. next E 1 ement () ; 

//Command execution succeeded; text being returned 

key = "text" + lineNumber; // Create a "dummy" key for 

this line of text 

vector = (Vector) attributes .get (key) ; 

for (int i=0; i < vector . size () ; i++) { 

text .addElement ( (String) vector . elementAt (i) ) ; 

} 

} 

return text; 

} 



/** 

* sets the raw response text 
* 

* ©param aRawResponse the raw WSP response text 

* ©return void 
*/ 

private void setRawResponse (String aRawResponse) { 
rawResponse = aRawResponse; 

} 



* sets the response result code 
★ 

* ©param inResultCode the WSP response result code 

* ©return void 
*/ 

private void setResultCode (String inResultCode) { 
resultCode = inResultCode; 

} 

/** 

* returns the WSP response result code and result message 

* ©return the WSP response result code and result message 
*/ 

public String getResultCodeAndMessage 0 { 

return (getResultCode ( ) + " " + getResultMessage ( ) ) ; 
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} 

/* * 

* returns the WSP response result code 

5 

* ©return the WSP response result code 
*/ 

public String getResultCode 0 { 
return resultCode; 

10 } 

/** 

* returns the WSP response major result code 
* 

15 * ©return the WSP response major result code 

*' 

public int getMajorResultCode () { 
parseResultCode ( ) ; 
return ma jorRe suit Code; 

20 } 

I * * 

* returns the WSP response minor result code 
* 

25 * ©return the WSP response minor result code 

*/ 

public int getMinorResultCode () { 
parseResultCode ( ) ; 
return minorResultCode; 

30 } 



35 



* sets the WSP response result message 



* ©param aResultMessage the WSP response result message 

* ©return void 
*/ 

private void setResultMessage (String aResultMessage) { 
40 resultMessage = aResultMessage; 

} 

/** 

45 * sets the WSP response attributes 

* 

* ©param hash the WSP response attributes 

* ©return void 
*/ 

50 private void setAttributes (Hashtable hash) { 

attributes = hash; 

) 



55 // -- 

// General Methods 
// 
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* parses the current result code into major and minor result codes. 
★ 

* ©return true if result code is successfully parsed, otherwise false 
*/ 

private boolean parseResultCode () { 
boolean rc = true; 

String methodName = className + " .parseResultCode ( ) " ; 

String sResultCode = getResultCode 0 ; 

String sMajorResultCode = null; 

String sMinorResultCode = null; 

int iMajorResultCode = 0; 

int iMinorResultCode = 0; 

try { 

StringTokenizer st = new StringTokenizer (sResultCode, ■'."}; 

sMa j or Re sul t Code = s t . next Token ( ) ; 
sMinorResultCode = st .nextToken ( ) ; 

iMajorResultCode = Integer .parselnt (sMajorResultCode) ; 
iMinorResultCode = Integer .parselnt (sMinorResultCode) ; 

} 

catch (NoSuchElementException nsee) { 

System. err. println (methodName + "Unable to parse result code 

+ sResultCode + ">") ; 
nsee . printStackTrace ( ) ; 

catch (NumberFormatException nfe) { 

System. err. println (methodName + "Invalid result code <" 

+ sResultCode + ">"); 
nfe .printStackTrace () ; 

} 

finally { 

if (iMajorResultCode <= 0) { 
rc = false; 

} 

else { 

majorResultCode = iMajorResultCode; 
minorResultCode = iMinorResultCode; 

} 

} 

return rc; 

} 

/** 

* prints debug-type representation of the WSP Response to standard 



output 

★ 



* ©param response a WSP resonse 

* ©return 'void 

public static void displayResponse (WSPResponse response) { 

System. out .println ("Result Code: ■ + response .getResultCode () ) ; 
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System. out .println ( "Major Result Code; " + 

response .getMajorResultCode 0 ) ; 
System. out .println ("Minor Result Code: 11 + 
response .getMinorResultCode ( ) ) ; 
5 System. out .println ( "Result Message: " + 

response .getResultMessage () ) ; 

Hashtable attributes = response .getAttributes () ; 

10 if (attributes == null) { 

System. out. print In ("Result Properties: NONE"); 
return; 

} 

15 System. out .println( "Result Properties:"); 

Enumeration enum = attributes . keys () ; 

while (enum.hasMoreElements () ) { 
20 String key ■ null; 

Vector vector o null; 



25 



key = (String) enum.nextElement () ; 
vector = (Vector) attributes .get (key) ; 



for (int i=0; i < vector . size () ; i++) { 
System. out .println (key + " : " + 
(String) vector .elementAt (i) ) ; 

} 

30 } 

} 

35 * returns the raw WSP response 

* 

* ©return a string representing the raw WSP response 
*/ 

public String toString 0 { 
40 if (rawResponse != null) { 

return rawResponse; 

} 

if (responseCode == null) { 

fabricatedResponse = new String ("001 . 001" ) ; 
45 } else { 

fabricatedResponse = new String (responseCode) ; 

if (resultMessage == null) { 

fabricatedResponse = new 
50 String(fabricatedResponse+"<<Message is null>>\r\n") ; 

} else { 

fabricatedResponse = new 
String (fabricatedResponse+resultMessage+"\r\n" ) ; 

} 

55 if (attributes != null) { 

Enumeration enum = attributes . keys () ; 
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while (enum.hasMoreElements () ) { 
String key = null; 
Vector vector = null; 

5 key = (String) enum. nextElement ( ) ; 

vector = (Vector) attributes .get (key) ; 

for (int i=0; i < vector . size () ; i++) { 
f abricatedResponse ■ new 
10 String (f abricatedResponse* key + 

(String) vector. elementAt (i) + 

"\r\n") ; 

15 } 

} 

} 

f abricatedResponse = new String (f abricatedResponse+" . \r\n" ) 
return f abricatedResponse; 

20 } 



25 



* Parse raw WSP text response and extract and store all components 



* ©param data the raw WSP text response 

* ©return void 

* ©exception InvalidResponseFormatException upon detection of an 
invalid response format 

30 */ 

private void parseRawResponse (String data) 

throws InvalidResponseFormatException { 

String methodName « className + " . parseRawResponse (String) ; 

35 // 

// Split data by <CRLF> 

// 

StringTokenizer st = new StringTokenizer (data, "XrXn 1 '); 

40 

// 

// Get the first line of the response 
// 

String responseLine = " "; 

45 

try { 

responseLine = st . nextToken ( ) ; 

} catch (NoSuchElementException e) { 
50 throw new InvalidResponseFormatException ( "Missing first 

line") ; 

} 



55 // 

// Extract "result code" and "result message" from first line 
//of response. 
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// 

int spacelndex = responseLine . indexOf ( 1 1 ) ; 

5 // 

// If there is no space in the string, then the format is invalid. 

// First line must be "code message" 

// 

if (spacelndex == -1) { 
10 throw new InvalidResponseFormatException( 

"missing/invalid code and message"); 

} 

// 

15 // The code is comprised of the set of characters spanning the 

// the first character to the space 
// 

String myresultCode = responseLine. substring (0, spacelndex); 

20 // 

// trim any whitespace from both ends of code 
// 

myresultCode = myresultCode . trim () ; 

25 // 

// Attempt to convert the string result code to an integer 

// 

setResultCode (myresultCode) ; 

30 // 

// Extract the result message now 
// 

String desc = null; 

35 // 

// The result message is comprised of all characters spanning from 
// the first character after the space to the end of the entire 

string 

// 

40 desc = responseLine . substring (spacelndex + 1, 

responseLine . length ( ) ) ; 

// 

// trim any whitespace from both ends of code 
45 // 

desc = desc.trimO; 

if (desc. length () == 0) { 

throw new InvalidResponseFormatException ( 
50 "Missing result message"); 

} 



55 



setResultMessage(desc) ,• 



String key; 
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String value; 

int colonlndex = 0; 

//if Command execution succeeded; text being returned 
5 if (getMajorResultCode 0 

COMMAND_EXECUTION_SUCCEEDED_TEXT_BEING_RETURNED) { 
int lineNumber = 0; 
try { 

while (st . hasMoreTokens 0 ) { 
10 lineNumber++; 

// 

// Create a "dummy" key for this line of text 
// 

15 key = "text" + lineNumber; 

// 

// Get the next line from the response 
// 

20 value = st . next Token () ; 



35 



// 

// Break from the loop if we hit the response 



terminator 

25 // 



if (value. trim{) .equals (".") ) { 
break; 

} 



30 // 

// Save attribute 



// 

//addAttribute (key. toLowerCase () , value) ; 
addAttribute (key, value) ; 

} // end while 



} // end try 

catch (NoSuchElementException e) { 

40 throw new Inval idResponseFormat Except ion ( 

"Error splitting response by » \r\n'" , e) ; 

} // end catch 

} 

45 else 

{ 

// 

// Iterate through the rest of the response, searching for 
50 // attributes. Break from the loop when we encounter the 

// response terminator 
// 

try { 

while ( st. hasMoreTokens () ) { 
55 // 

// Get the next line from the response 
// 
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10 



15 



20 



25 



30 



we've 
haven 1 t , 



response terminator 



responseLine = st .nextTokenO ; 
// 

// Try to find the colon (':') in the string 
// 

colonlndex = responseLine . indexOf (':'); 
// 

// If the colon is missing, then check to see if 

// encountered the response terminator. If we 

// then the response is formatted improperly 
// 

if (colonlndex == -1) { 

responseLine = responseLine . trim () ; 

// 

// Break from the loop if we hit the 
// 

if (responseLine, equals (".") ) { 
break; 



} 

else { 



InvalidResponseFormatException ( 
pair") ; 

} 



throw new 

"Invalid attribute key- value 



35 



40 



45 



50 



55 



colon 



colon 



// 

// The attribute key is everything before the 
// 

key = responseLine. substring (0, colonlndex); 
key = key . trim () ; 

// 

// The attribute value is everything after the 
// 

value = responseLine. substring (colonlndex + 1) ; 
value = value . trim ( ) ; 

// 

// Save attribute 
// 

//addAttribute(key.toLowerCase() , value) ; 
addAttribute (key, value); 

} // end while 

} // end try 

catch (NoSuchElementException e) { 

throw new InvalidResponseFormatException( 
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"Error splitting response by , \r\n"\ e) 
} // end catch 



} 

} / /parseRawRespose 



/* * 

* Attributes are stored in a hashtable. Since there can be multiple 

* values for the same key, we store all values in vectors. Everytime 

* a value is added for a key that already exists, we just add that 

* value to that key's vector. If a key does not yet exist, then 

* we create a new vector and add the value to it . 

* ©param key a result property key 

* ©param value a result property value 

* ©return void 
*/ 

private void addAttribute (String key, String value) { 
Hashtable hash = getAttributes 0 / 

if (hash == null) { 

hash = new Hashtable ( ) ; 
setAttributes (hash) ; 

} 

Vector vector = (Vector) hash. get (key) ; 

if (vector == null) { 

vector = new Vector (1); 
hash. put (key, vector) ; 

} 

vector .addElement (value) ; 

} 



} 

// - - 

// End of file WSPResponse . java 

// Copyright (c) 2000 Network Solutions, Inc 
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WHAT IS CLAIMED IS: 

1 . A method for interfacing a user application program to a system for conducting a 
transaction associated with managing Internet domain names, comprising the 
steps of: 

receiving a request in an application program interface from the 

application program to establish over the Internet a session 

between the user and the system; 
authenticating the right of the user to conduct a transaction associated with 

managing Internet domain names; 
establishing a secure socket layer within the application program interface 

and the system; 

receiving a request in the application program interface from the 

applications program to initiate a transaction following such 
authentication; and 

transmitting commands from the application program interface, to the 
system effectuating the transaction. 



2. A method as set forth in claim 1 , further comprising the step of: 

notifying the application program as to the status of processing of the 
command. 
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3. A method as set forth in claim 2, wherein: 

the notifying step comprises the step of returning a response to the 
application program containing a statement indicating whether the 
transaction has been fulfilled. 

4. A method as set forth in claim 3, wherein: 

the statement comprises a message which includes an ASCII text portion, 
followed by a delimiter portion. 

5. A method as set forth in claim 4, wherein: 

the ASCII text portion is selected from a predefined dictionary of statements. 

6. A method as set forth in claim 1 , wherein: 

authenticating the user is determined from the Internet Protocol address, 
secure socket layer encryption, and user name and password provided by 
the application program. 

7. A method as set forth in claim 1 , wherein: 

the authenticating step includes the step of at least one additional attempt 
to authenticate the user following a first failed attempt. 
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A method as set forth in claim 7, wherein: 

following said at least one additional attempt to authenticate the user is denied 
further attempts to be authenticated should said at least one additional attempt fail. 

Apparatus for interfacing a user application program to a system for conducting 
transactions associated with managing Internet Domain Names comprising: 
a component for receiving a request from an applications program to 

establish over the Internet a connection between a user and the 

system; 

a component for authenticating the right of the user to conduct a 

transaction associated with managing Internet domain names; 

a component for establishing a secure socket layer within the apparatus; 

a component for initiating a transaction following such authentication and 
following receipt of a request from the applications program; and 

a component for transmitting commands for effectuating the transaction 
via the secure socket layer to the system. 
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